diff --git a/libfwupdplugin/fu-device.h b/libfwupdplugin/fu-device.h
index 7741df895..c16aeeb77 100644
--- a/libfwupdplugin/fu-device.h
+++ b/libfwupdplugin/fu-device.h
@@ -134,7 +134,17 @@ typedef enum {
  */
 #define FU_DEVICE_REMOVE_DELAY_USER_REPLUG		40000
 
-typedef gboolean (*FuDeviceRetryFunc)			(FuDevice	*device,
+/**
+ * FuDeviceRetryFunc:
+ * @self: a #FuDevice
+ * @user_data: user data
+ * @error: (nullable): optional return location for an error
+ *
+ * The device retry iteration callback.
+ *
+ * Returns: %TRUE on success
+ */
+typedef gboolean (*FuDeviceRetryFunc)			(FuDevice	*self,
 							 gpointer	 user_data,
 							 GError		**error)
 							 G_GNUC_WARN_UNUSED_RESULT;