From 2e772f3085202f1a9289b6976af8ae3490044056 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
Date: Tue, 12 Dec 2017 20:53:00 +0100
Subject: [PATCH] man: tone down the note that reboot/halt/poweroff are legacy

They may be old (or rather compatible implementations of old commands), but
they certainly are not going away. Apart from privilege escalation through
polkit, they are mostly equivalent.
---
 man/halt.xml | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/man/halt.xml b/man/halt.xml
index 0abcdb475c..78860d94dd 100644
--- a/man/halt.xml
+++ b/man/halt.xml
@@ -166,8 +166,12 @@
   <refsect1>
     <title>Notes</title>
 
-    <para>These are legacy commands available for compatibility
-    only.</para>
+    <para>These commands are implemented in a way that preserves compatiblity 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>
   </refsect1>
 
   <refsect1>