man: explicitly document that "reboot -f" is different from "systemctl reboot -f"

Closes #24696.

diff --git a/man/halt.xml b/man/halt.xml
index 7ab21c148fbb56aae87252cb49c82454c5f06ae2..6d272f7daf7c109b56df8cfc8e60663c8ba0bf15 100644 (file)
--- a/man/halt.xml
+++ b/man/halt.xml
@@ -84,8 +84,12 @@
         <term><option>-f</option></term>
         <term><option>--force</option></term>
 
-        <listitem><para>Force immediate halt, power-off, reboot. Do
-        not contact the init system.</para></listitem>
+        <listitem>
+          <para>Force immediate halt, power-off, reboot. If specified, the command does not contact the init
+          system. In most cases, filesystems are not properly unmounted before shutdown. For example, the
+          command <command>reboot -f</command> is mostly equivalent to <command>systemctl reboot -ff</command>,
+          instead of <command>systemctl reboot -f</command>.</para>
+        </listitem>
       </varlistentry>
 
       <varlistentry>