diff --git a/libfwupdplugin/fu-efivar.c b/libfwupdplugin/fu-efivar.c
index 7dc82c661..d2f025fb0 100644
--- a/libfwupdplugin/fu-efivar.c
+++ b/libfwupdplugin/fu-efivar.c
@@ -457,7 +457,7 @@ fu_efivar_get_names (const gchar *guid, GError **error)
  *
  * Returns a file monitor for a specific key.
  *
- * Returns: %TRUE on success
+ * Returns: (transfer full): a #GFileMonitor, or %NULL for an error
  *
  * Since: 1.5.5
  **/
diff --git a/libfwupdplugin/fu-hwids.c b/libfwupdplugin/fu-hwids.c
index cef5f1574..f51c64cbe 100644
--- a/libfwupdplugin/fu-hwids.c
+++ b/libfwupdplugin/fu-hwids.c
@@ -233,7 +233,7 @@ fu_hwids_get_replace_keys (FuHwids *self, const gchar *key)
 /**
  * fu_hwids_add_smbios_override:
  * @self: A #FuHwids
- * @keys: A key, e.g. %FU_HWIDS_KEY_PRODUCT_SKU
+ * @key: A key, e.g. %FU_HWIDS_KEY_PRODUCT_SKU
  * @value: (nullable): A new value, e.g. "ExampleModel" or %NULL
  *
  * Sets SMBIOS override values so you can emulate another system.