diff --git a/libfwupd/fwupd-enums.c b/libfwupd/fwupd-enums.c
index 16d3356da..63ebf6d42 100644
--- a/libfwupd/fwupd-enums.c
+++ b/libfwupd/fwupd-enums.c
@@ -578,7 +578,7 @@ fwupd_release_urgency_to_string (FwupdReleaseUrgency release_urgency)
 
 /**
  * fwupd_release_urgency_from_string:
- * @release_urgency: A string, e.g. `trusted-payload`
+ * @release_urgency: A string, e.g. `low`
  *
  * Converts a string to an enumerated value.
  *
diff --git a/libfwupd/fwupd-security-attr.c b/libfwupd/fwupd-security-attr.c
index 7e3613110..1adeabd73 100644
--- a/libfwupd/fwupd-security-attr.c
+++ b/libfwupd/fwupd-security-attr.c
@@ -364,7 +364,7 @@ fwupd_security_attr_get_flags (FwupdSecurityAttr *self)
 /**
  * fwupd_security_attr_set_flags:
  * @self: A #FwupdSecurityAttr
- * @flags: the self flags, e.g. %FWUPD_SECURITY_ATTR_FLAG_TRUSTED_PAYLOAD
+ * @flags: the self flags, e.g. %FWUPD_SECURITY_ATTR_FLAG_OBSOLETED
  *
  * Sets the self flags.
  *