diff --git a/NEWS b/NEWS
index 0123d35e0f..f6b08b04c3 100644
--- a/NEWS
+++ b/NEWS
@@ -65,11 +65,12 @@ CHANGES WITH 260 in spe:
support for the old way using protofiles.
* The org.systemd.login1.Manager D-Bus interface has a minor API break.
- The `CanPowerOff()`, `CanReboot()`, `CanSuspend()`, etc. family of
+ The 'CanPowerOff()', 'CanReboot()', 'CanSuspend()', etc. family of
methods have introduced new return values which may break downstream
consumers, such as desktop environments. The new return values more
- precisely communicate the status of inhibitors. This allows desktops
- to differentiate between system administrator policy and
+ precisely communicate the status of inhibitors: 'inhibited',
+ 'inhibitor-blocked', and 'challenge-inhibitor-blocked'. This allows
+ desktops to differentiate between system administrator policy and
temporary restrictions imposed by inhibitors.
New system interfaces and components:
diff --git a/man/org.freedesktop.login1.xml b/man/org.freedesktop.login1.xml
index dc80e96717..bb1ee0b337 100644
--- a/man/org.freedesktop.login1.xml
+++ b/man/org.freedesktop.login1.xml
@@ -711,9 +711,10 @@ node /org/freedesktop/login1 {
CanRebootToBootLoaderMenu(), and CanRebootToBootLoaderEntry()
test whether the system supports the respective operation and whether the calling user is allowed to
execute it. Returns one of na, yes, no,
- challenge, and inhibited. If na is returned,
- the operation is not available because hardware, kernel, or drivers do not support it. If yes
- is returned, the operation is supported and the user may execute the operation without further authentication.
+ challenge, inhibited, inhibitor-blocked,
+ and challenge-inhibitor-blocked. If na is returned, the operation
+ is not available because hardware, kernel, or drivers do not support it. If yes is
+ returned, the operation is supported and the user may execute the operation without further authentication.
If no is returned, the operation is available but the user is not allowed to execute
the operation. If challenge is returned, the operation is available but only after
authorization. If inhibited is returned, the operation is normally available without