From 6dfaeac3704c68a1e297cef0c08e5b6ee1dbf3b7 Mon Sep 17 00:00:00 2001
From: Nick Rosbrook <nick.rosbrook@canonical.com>
Date: Fri, 28 Oct 2022 11:01:15 -0400
Subject: [PATCH] man: document reboot --poweroff exception

When reboot is invoked, the -p/--poweroff option is intentionally
ignored. Update the man page to reflect this exception.
---
 man/halt.xml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/man/halt.xml b/man/halt.xml
index 6d272f7daf7..c13ee5c1448 100644
--- a/man/halt.xml
+++ b/man/halt.xml
@@ -69,8 +69,9 @@
         <term><option>-p</option></term>
         <term><option>--poweroff</option></term>
 
-        <listitem><para>Power-off the machine, regardless of which one
-        of the three commands is invoked.</para></listitem>
+        <listitem><para>Power-off the machine, when either <command>halt</command>
+        or <command>poweroff</command> is invoked. This option is ignored when
+        <command>reboot</command> is invoked.</para></listitem>
       </varlistentry>
 
       <varlistentry>
-- 
2.47.3