summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2020-01-16 19:01:05 +0100
committerLennart Poettering <lennart@poettering.net>2020-01-17 10:08:23 +0100
commit59d83463d18c1928cd3d6c4aa0bde6285d2af734 (patch)
treec80c1a394b19ef26f1d637da11c64a3cbaec9921 /man
parent0b306655f1eca3bbb28a2e3bc295a7bd4dc292bd (diff)
downloadsystemd-59d83463d18c1928cd3d6c4aa0bde6285d2af734.tar.gz
man: extend on halt documentation
Based on the suggestions on #13254 and #13264 Fixes: #13254
Diffstat (limited to 'man')
-rw-r--r--man/halt.xml20
1 files changed, 11 insertions, 9 deletions
diff --git a/man/halt.xml b/man/halt.xml
index 75604b8342..f811b10348 100644
--- a/man/halt.xml
+++ b/man/halt.xml
@@ -41,9 +41,8 @@
<refsect1>
<title>Description</title>
- <para><command>halt</command>, <command>poweroff</command>,
- <command>reboot</command> may be used to halt, power-off or reboot
- the machine.</para>
+ <para><command>halt</command>, <command>poweroff</command>, <command>reboot</command> may be used to
+ halt, power-off, or reboot the machine. All three commands take the same options.</para>
</refsect1>
@@ -137,12 +136,15 @@
<refsect1>
<title>Notes</title>
- <para>These commands are implemented in a way that preserves compatibility with
- the original SysV commands.
- <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
- verbs <command>halt</command>, <command>poweroff</command>,
- <command>reboot</command> provide the same functionality with some additional
- features.</para>
+ <para>These commands are implemented in a way that preserves basic compatibility with the original SysV
+ commands. <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+ verbs <command>halt</command>, <command>poweroff</command>, <command>reboot</command> provide the same
+ functionality with some additional features.</para>
+
+ <para>Note that on many SysV systems <command>halt</command> used to be synonymous to
+ <command>poweroff</command>, i.e. both commands would equally result in powering the machine off. systemd
+ is more accurate here, and <command>halt</command> results in halting the machine only (leaving power
+ on), and <command>poweroff</command> is required to actually power it off.</para>
</refsect1>
<refsect1>