diff --git a/libfwupd/fwupd-security-attr.c b/libfwupd/fwupd-security-attr.c
index 122e3173d..aab2f4f0c 100644
--- a/libfwupd/fwupd-security-attr.c
+++ b/libfwupd/fwupd-security-attr.c
@@ -917,7 +917,7 @@ fwupd_security_attr_array_from_variant (GVariant *value)
 
 /**
  * fwupd_security_attr_new:
- * @appstream_id: (allow-none): the AppStream component ID, e.g. `com.intel.BiosGuard`
+ * @appstream_id: (nullable): the AppStream component ID, e.g. `com.intel.BiosGuard`
  *
  * Creates a new self.
  *
diff --git a/libfwupdplugin/fu-common.c b/libfwupdplugin/fu-common.c
index 2bcc96569..4d6be8a49 100644
--- a/libfwupdplugin/fu-common.c
+++ b/libfwupdplugin/fu-common.c
@@ -2120,7 +2120,7 @@ fu_memdup_safe (const guint8 *src, gsize n, GError **error)
  * @buf: source buffer
  * @bufsz: maximum size of @buf, typically `sizeof(buf)`
  * @offset: offset in bytes into @buf to copy from
- * @value: (out) (allow-none): the parsed value
+ * @value: (out) (nullable): the parsed value
  * @error: A #GError or %NULL
  *
  * Read a value from a buffer in a safe way.
@@ -2159,7 +2159,7 @@ fu_common_read_uint8_safe (const guint8 *buf,
  * @buf: source buffer
  * @bufsz: maximum size of @buf, typically `sizeof(buf)`
  * @offset: offset in bytes into @buf to copy from
- * @value: (out) (allow-none): the parsed value
+ * @value: (out) (nullable): the parsed value
  * @endian: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
  * @error: A #GError or %NULL
  *
@@ -2200,7 +2200,7 @@ fu_common_read_uint16_safe (const guint8 *buf,
  * @buf: source buffer
  * @bufsz: maximum size of @buf, typically `sizeof(buf)`
  * @offset: offset in bytes into @buf to copy from
- * @value: (out) (allow-none): the parsed value
+ * @value: (out) (nullable): the parsed value
  * @endian: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
  * @error: A #GError or %NULL
  *
@@ -2241,7 +2241,7 @@ fu_common_read_uint32_safe (const guint8 *buf,
  * @buf: source buffer
  * @bufsz: maximum size of @buf, typically `sizeof(buf)`
  * @offset: offset in bytes into @buf to copy from
- * @value: (out) (allow-none): the parsed value
+ * @value: (out) (nullable): the parsed value
  * @endian: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
  * @error: A #GError or %NULL
  *
diff --git a/libfwupdplugin/fu-device.c b/libfwupdplugin/fu-device.c
index a591bcc9e..aedc62823 100644
--- a/libfwupdplugin/fu-device.c
+++ b/libfwupdplugin/fu-device.c
@@ -1874,7 +1874,7 @@ fu_device_set_version_format (FuDevice *self, FwupdVersionFormat fmt)
 /**
  * fu_device_set_version:
  * @self: A #FuDevice
- * @version: (allow-none): a string, e.g. `1.2.3`
+ * @version: (nullable): a string, e.g. `1.2.3`
  *
  * Sets the device version, sanitizing the string if required.
  *
@@ -1917,7 +1917,7 @@ fu_device_set_version (FuDevice *self, const gchar *version)
 /**
  * fu_device_set_version_lowest:
  * @self: A #FuDevice
- * @version: (allow-none): a string, e.g. `1.2.3`
+ * @version: (nullable): a string, e.g. `1.2.3`
  *
  * Sets the device lowest version, sanitizing the string if required.
  *
@@ -1960,7 +1960,7 @@ fu_device_set_version_lowest (FuDevice *self, const gchar *version)
 /**
  * fu_device_set_version_bootloader:
  * @self: A #FuDevice
- * @version: (allow-none): a string, e.g. `1.2.3`
+ * @version: (nullable): a string, e.g. `1.2.3`
  *
  * Sets the device bootloader version, sanitizing the string if required.
  *
@@ -2051,7 +2051,7 @@ fu_device_ensure_inhibits (FuDevice *self)
  * fu_device_inhibit:
  * @self: A #FuDevice
  * @inhibit_id: an ID used for uninhibiting, e.g. `low-power`
- * @reason: (allow-none): a string, e.g. `Cannot update as foo [bar] needs reboot`
+ * @reason: (nullable): a string, e.g. `Cannot update as foo [bar] needs reboot`
  *
  * Prevent the device from being updated, changing it from %FWUPD_DEVICE_FLAG_UPDATABLE
  * to %FWUPD_DEVICE_FLAG_UPDATABLE_HIDDEN if not already inhibited.
diff --git a/libfwupdplugin/fu-udev-device.c b/libfwupdplugin/fu-udev-device.c
index 9c15f72a0..0dac20b55 100644
--- a/libfwupdplugin/fu-udev-device.c
+++ b/libfwupdplugin/fu-udev-device.c
@@ -1353,7 +1353,7 @@ fu_udev_device_close (FuDevice *device, GError **error)
  * @self: A #FuUdevDevice
  * @request: request number
  * @buf: A buffer to use, which *must* be large enough for the request
- * @rc: (out) (allow-none): the raw return value from the ioctl
+ * @rc: (out) (nullable): the raw return value from the ioctl
  * @error: A #GError, or %NULL
  *
  * Control a device using a low-level request.