man: document path units

[elogind.git] / man / systemctl.xml

diff --git a/man/systemctl.xml b/man/systemctl.xml
index 2ffc87df2b2ada7eb72ddd78d2bb10de1973d697..80f355491fa8aa9cd4ca591ce163f3766677c868 100644 (file)
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -70,7 +70,7 @@
                 <variablelist>
                         <varlistentry>
                                 <term><option>--help</option></term>
-                                <term><option>--h</option></term>
+                                <term><option>-h</option></term>
 
                                 <listitem><para>Prints a short help
                                 text and exits.</para></listitem>
@@ -78,6 +78,7 @@
 
                         <varlistentry>
                                 <term><option>--type=</option></term>
+                                <term><option>-t</option></term>
 
                                 <listitem><para>When listing units,
                                 limit display to certain unit
@@ -91,6 +92,7 @@
 
                         <varlistentry>
                                 <term><option>--all</option></term>
+                                <term><option>-a</option></term>
 
                                 <listitem><para>When listing units,
                                 show all units, regardless of their
@@ -125,11 +127,25 @@
                         </varlistentry>
 
                         <varlistentry>
-                                <term><option>--block</option></term>
+                                <term><option>--no-block</option></term>
 
-                                <listitem><para>Synchronously wait for
-                                the requested operation to
-                                finish.</para></listitem>
+                                <listitem><para>Do no synchronously
+                                wait for the requested operation to
+                                finish. If this is not specified the
+                                job will be verified, enqueued and
+                                wait until it is complete. By passing
+                                this argument it is only verified and
+                                enqueued.</para></listitem>
+                        </varlistentry>
+
+                        <varlistentry>
+                                <term><option>--quiet</option></term>
+                                <term><option>-q</option></term>
+
+                                <listitem><para>Suppress output to
+                                STDOUT for <command>snapshot</command>
+                                and
+                                <command>check</command>.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>
@@ -178,7 +194,7 @@
                                 cannot be used to reload unit
                                 configuration. Use the
                                 <command>daemon-reload</command>
-                                command for that. All in all this
+                                command for that. All in all, this
                                 command is of little use except for
                                 debugging.</para>
                                 <para>This command should not be
@@ -251,6 +267,18 @@
                                 dependencies and stop all
                                 others.</para></listitem>
                         </varlistentry>
+                        <varlistentry>
+                                <term><command>check [NAME...]</command></term>
+
+                                <listitem><para>Check whether any of
+                                the specified units is active
+                                (i.e. running). Returns 0 if at least
+                                one is active, non-zero
+                                otherwise. Unless
+                                <option>--quiet</option> is specified
+                                this will also print the current unit
+                                state to STDOUT.</para></listitem>
+                        </varlistentry>
                         <varlistentry>
                                 <term><command>monitor</command></term>
 
@@ -276,12 +304,14 @@
                                 <term><command>snapshot [NAME]</command></term>
 
                                 <listitem><para>Create a snapshot. If
-                                a snapshot name is specified the new
+                                a snapshot name is specified, the new
                                 snapshot will be named after it. If
                                 none is specified an automatic
                                 snapshot name is generated. In either
-                                case the snapshot name used is printed
-                                to STDOUT.</para>
+                                case, the snapshot name used is
+                                printed to STDOUT, unless
+                                <option>--quiet</option> is
+                                specified.</para>
 
                                 <para>A snapshot refers to a saved
                                 state of the systemd manager. It is
@@ -308,8 +338,8 @@
                                 configuration. This will reload all
                                 unit files and recreate the entire
                                 dependency tree. While the daemon is
-                                reloaded all sockets systemd listens
-                                on on behalf of user configuration will
+                                reloaded, all sockets systemd listens
+                                on on behalf of user configuration, will
                                 stay accessible.</para> <para>This
                                 command should not be confused with
                                 the <command>load</command> or