From cb19517490104553907bb0b118cd2005d6e379cc Mon Sep 17 00:00:00 2001
From: Yu Watanabe <watanabe.yu+github@gmail.com>
Date: Sat, 17 Sep 2022 01:25:44 +0900
Subject: [PATCH] man: explicitly document that "reboot -f" is different from
 "systemctl reboot -f"

Closes #24696.
---
 man/halt.xml | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/man/halt.xml b/man/halt.xml
index 7ab21c148f..6d272f7daf 100644
--- 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>