diff --git a/libfwupd/fwupd-remote.h b/libfwupd/fwupd-remote.h
index e4de38346..16ed1b9c4 100644
--- a/libfwupd/fwupd-remote.h
+++ b/libfwupd/fwupd-remote.h
@@ -42,6 +42,14 @@ struct _FwupdRemoteClass
 	void (*_fwupd_reserved7)	(void);
 };
 
+/**
+ * FwupdRemoteKind:
+ * @FWUPD_REMOTE_KIND_UNKNOWN:			Unknown kind
+ * @FWUPD_REMOTE_KIND_DOWNLOAD:			Requires files to be downloaded
+ * @FWUPD_REMOTE_KIND_LOCAL:			Reads files from the local machine
+ *
+ * The kind of remote.
+ **/
 typedef enum {
 	FWUPD_REMOTE_KIND_UNKNOWN,
 	FWUPD_REMOTE_KIND_DOWNLOAD,
diff --git a/src/fu-common.c b/src/fu-common.c
index e88e580e3..31759793c 100644
--- a/src/fu-common.c
+++ b/src/fu-common.c
@@ -117,7 +117,7 @@ fu_common_get_file_list_internal (GPtrArray *files, const gchar *directory, GErr
 
 /**
  * fu_common_get_files_recursive:
- * @directory: a directory name
+ * @path: a directory name
  * @error: A #GError or %NULL
  *
  * Returns every file found under @directory, and any subdirectory.
@@ -599,7 +599,7 @@ fu_common_spawn_sync (const gchar * const * argv,
  * fu_common_write_uint16:
  * @buf: A writable buffer
  * @val_native: a value in host byte-order
- * @error: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
+ * @endian: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
  *
  * Writes a value to a buffer using a specified endian.
  **/
@@ -624,7 +624,7 @@ fu_common_write_uint16 (guint8 *buf, guint16 val_native, FuEndianType endian)
  * fu_common_write_uint32:
  * @buf: A writable buffer
  * @val_native: a value in host byte-order
- * @error: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
+ * @endian: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
  *
  * Writes a value to a buffer using a specified endian.
  **/
@@ -648,7 +648,7 @@ fu_common_write_uint32 (guint8 *buf, guint32 val_native, FuEndianType endian)
 /**
  * fu_common_read_uint16:
  * @buf: A readable buffer
- * @error: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
+ * @endian: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
  *
  * Read a value from a buffer using a specified endian.
  *
@@ -675,7 +675,7 @@ fu_common_read_uint16 (const guint8 *buf, FuEndianType endian)
 /**
  * fu_common_read_uint32:
  * @buf: A readable buffer
- * @error: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
+ * @endian: A #FuEndianType, e.g. %G_LITTLE_ENDIAN
  *
  * Read a value from a buffer using a specified endian.
  *
diff --git a/src/fu-device-list.c b/src/fu-device-list.c
index 0d54389e6..f70d82081 100644
--- a/src/fu-device-list.c
+++ b/src/fu-device-list.c
@@ -357,7 +357,6 @@ fu_device_list_add_missing_guids (FuDevice *device_new, FuDevice *device_old)
  * fu_device_list_add:
  * @self: A #FuDeviceList
  * @device: A #FuDevice
- * @error: A #GError, or %NULL
  *
  * Adds a specific device to the device list if not already present.
  *
diff --git a/src/fu-history.h b/src/fu-history.h
index a8d6b07a7..b27578507 100644
--- a/src/fu-history.h
+++ b/src/fu-history.h
@@ -31,10 +31,19 @@ G_BEGIN_DECLS
 #define FU_TYPE_PENDING (fu_history_get_type ())
 G_DECLARE_FINAL_TYPE (FuHistory, fu_history, FU, HISTORY, GObject)
 
+/**
+ * FuHistoryFlags:
+ * @FU_HISTORY_FLAGS_NONE:			No flags set
+ * @FU_HISTORY_FLAGS_MATCH_OLD_VERSION:		Match previous firmware version
+ * @FU_HISTORY_FLAGS_MATCH_NEW_VERSION:		Match new firmware version
+ *
+ * The flags to use when matching devices against the history database.
+ **/
 typedef enum {
 	FU_HISTORY_FLAGS_NONE			= 0,
 	FU_HISTORY_FLAGS_MATCH_OLD_VERSION	= 1 << 0,
 	FU_HISTORY_FLAGS_MATCH_NEW_VERSION	= 1 << 1,
+	/*< private >*/
 	FU_HISTORY_FLAGS_LAST
 } FuHistoryFlags;
 
diff --git a/src/fu-usb-device.c b/src/fu-usb-device.c
index 8f0487575..15ec0cfc1 100644
--- a/src/fu-usb-device.c
+++ b/src/fu-usb-device.c
@@ -460,6 +460,7 @@ fu_usb_device_get_dev (FuUsbDevice *device)
 
 /**
  * fu_usb_device_new:
+ * @usb_device: A #GUsbDevice
  *
  * Creates a new #FuUsbDevice.
  *