man: don't document systemctl --failed

[elogind.git] / man / systemctl.xml

diff --git a/man/systemctl.xml b/man/systemctl.xml
index a486c735e502c2cc54797961083d8ab6a5ddf51f..8a4cff8833a578a7a8617919e5d37b1f38e3daf0 100644 (file)
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -98,9 +98,10 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
         <term><option>--state=</option></term>
 
         <listitem>
-        <para>The argument should be a comma-separated list of unit LOAD,
-        SUB, or ACTIVE states. When listing units, show only those
-        in specified states.</para>
+        <para>The argument should be a comma-separated list of unit
+        LOAD, SUB, or ACTIVE states. When listing units, show only
+        those in specified states. Use <option>--state=failed</option>
+        to show only failed units.</para>
         </listitem>
       </varlistentry>
 
@@ -321,6 +322,11 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
       <xi:include href="user-system-options.xml" xpointer="user" />
       <xi:include href="user-system-options.xml" xpointer="system" />
 
+      <!-- we do not document -failed here, as it has been made
+           redundant by -state=failed, which it predates. To keep
+           things simple we only document the new switch, while
+           keeping the old one around for compatibility only. -->
+
       <varlistentry>
         <term><option>--no-wall</option></term>
 
@@ -1350,15 +1356,15 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
                   <row>
                     <entry><varname>initializing</varname></entry>
                     <entry><para>Early bootup, before
-                    <filename>sysinit.target</filename> is reached
-                    or <varname>maintenance</varname> state entered.
+                    <filename>basic.target</filename> is reached
+                    or the <varname>maintenance</varname> state entered.
                     </para></entry>
                   </row>
                   <row>
                     <entry><varname>starting</varname></entry>
-                    <entry><para>Late bootup, before the default
-                    target or one of the rescue targets are
-                    reached.</para></entry>
+                    <entry><para>Late bootup, before the job queue
+                    becomes idle for the first time, or one of the
+                    rescue targets are reached.</para></entry>
                   </row>
                   <row>
                     <entry><varname>running</varname></entry>
@@ -1372,7 +1378,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
                   </row>
                   <row>
                     <entry><varname>maintenance</varname></entry>
-                    <entry><para>One of the rescue targets is
+                    <entry><para>The rescue or emergency target is
                     active.</para></entry>
                   </row>
                   <row>