diff --git a/libfwupdplugin/fu-archive.h b/libfwupdplugin/fu-archive.h
index 72ce0bfea..564024274 100644
--- a/libfwupdplugin/fu-archive.h
+++ b/libfwupdplugin/fu-archive.h
@@ -32,6 +32,7 @@ typedef enum {
  * @filename: A filename.
  * @bytes: The blob referenced by @filename.
  * @user_data: User data.
+ * @error: a #GError or NULL
  *
  * Specifies the type of archive iteration function.
  */
diff --git a/libfwupdplugin/fu-firmware-image.c b/libfwupdplugin/fu-firmware-image.c
index a7c3034bc..f4f1795bc 100644
--- a/libfwupdplugin/fu-firmware-image.c
+++ b/libfwupdplugin/fu-firmware-image.c
@@ -12,10 +12,10 @@
 #include "fu-firmware-image-private.h"
 
 /**
- * SECTION:fu-firmware_image
- * @short_description: a firmware_image file
+ * SECTION:fu-firmware-image
+ * @short_description: a firmware image section
  *
- * An object that represents a firmware_image file.
+ * An object that represents an image within the firmware file.
  */
 
 typedef struct {
diff --git a/libfwupdplugin/fu-hid-device.h b/libfwupdplugin/fu-hid-device.h
index 4ab2958b6..4f2d9b4f4 100644
--- a/libfwupdplugin/fu-hid-device.h
+++ b/libfwupdplugin/fu-hid-device.h
@@ -41,6 +41,7 @@ typedef enum {
 	FU_HID_DEVICE_FLAG_RETRY_FAILURE	= 1 << 2,
 	FU_HID_DEVICE_FLAG_NO_KERNEL_UNBIND	= 1 << 3,
 	FU_HID_DEVICE_FLAG_NO_KERNEL_REBIND	= 1 << 4,
+	/*< private >*/
 	FU_HID_DEVICE_FLAG_LAST
 } FuHidDeviceFlags;
 
diff --git a/libfwupdplugin/fu-plugin-vfuncs.h b/libfwupdplugin/fu-plugin-vfuncs.h
index 8b9292092..834c4618c 100644
--- a/libfwupdplugin/fu-plugin-vfuncs.h
+++ b/libfwupdplugin/fu-plugin-vfuncs.h
@@ -315,7 +315,7 @@ gboolean	 fu_plugin_udev_device_changed		(FuPlugin	*plugin,
 /**
  * fu_plugin_device_added
  * @plugin: A #FuPlugin
- * @device: A #FuDevice
+ * @dev: A #FuDevice
  *
  * Function run when the subclassed device has been added.
  *
@@ -339,7 +339,7 @@ gboolean	 fu_plugin_device_removed		(FuPlugin	*plugin,
 /**
  * fu_plugin_device_created
  * @plugin: A #FuPlugin
- * @device: A #FuDevice
+ * @dev: A #FuDevice
  * @error: A #GError or %NULL
  *
  * Function run when the subclassed device has been created.
@@ -352,7 +352,7 @@ gboolean	 fu_plugin_device_created		(FuPlugin	*plugin,
 /**
  * fu_plugin_device_registered
  * @plugin: A #FuPlugin
- * @device: A #FuDevice
+ * @dev: A #FuDevice
  *
  * Function run when device registered from another plugin.
  *
diff --git a/libfwupdplugin/fu-plugin.c b/libfwupdplugin/fu-plugin.c
index d24f6a740..c8768f2ba 100644
--- a/libfwupdplugin/fu-plugin.c
+++ b/libfwupdplugin/fu-plugin.c
@@ -1563,6 +1563,8 @@ fu_plugin_runner_composite_cleanup (FuPlugin *self, GPtrArray *devices, GError *
 /**
  * fu_plugin_runner_update_prepare:
  * @self: a #FuPlugin
+ * @flags: #FwupdInstallFlags
+ * @device: a #FuDevice
  * @error: a #GError or NULL
  *
  * Runs the update_prepare routine for the plugin
@@ -1583,6 +1585,8 @@ fu_plugin_runner_update_prepare (FuPlugin *self, FwupdInstallFlags flags, FuDevi
 /**
  * fu_plugin_runner_update_cleanup:
  * @self: a #FuPlugin
+ * @flags: #FwupdInstallFlags
+ * @device: a #FuDevice
  * @error: a #GError or NULL
  *
  * Runs the update_cleanup routine for the plugin
@@ -1645,6 +1649,7 @@ fu_plugin_runner_update_detach (FuPlugin *self, FuDevice *device, GError **error
 /**
  * fu_plugin_runner_update_reload:
  * @self: a #FuPlugin
+ * @device: A #FuDevice
  * @error: a #GError or NULL
  *
  * Runs reload routine for a device
diff --git a/libfwupdplugin/fu-udev-device.h b/libfwupdplugin/fu-udev-device.h
index f5698e1cc..a973c521c 100644
--- a/libfwupdplugin/fu-udev-device.h
+++ b/libfwupdplugin/fu-udev-device.h
@@ -42,6 +42,7 @@ struct _FuUdevDeviceClass
  * @FU_UDEV_DEVICE_FLAG_OPEN_WRITE:		Open the device write-only
  * @FU_UDEV_DEVICE_FLAG_VENDOR_FROM_PARENT:	Get the vendor ID fallback from the parent
  * @FU_UDEV_DEVICE_FLAG_USE_CONFIG:		Read and write from the device config
+ * @FU_UDEV_DEVICE_FLAG_OPEN_NONBLOCK:		Open nonblocking, e.g. O_NONBLOCK
  *
  * Flags used when opening the device using fu_device_open().
  **/