9fc0f6
From ce006689117c3226ddb0eb5a1f8e5963cab1c92a Mon Sep 17 00:00:00 2001
9fc0f6
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
9fc0f6
Date: Sun, 8 Dec 2013 18:56:16 -0500
9fc0f6
Subject: [PATCH] man: document 'is-enabled' output
9fc0f6
9fc0f6
https://bugzilla.redhat.com/show_bug.cgi?id=953077
9fc0f6
---
9fc0f6
 man/systemctl.xml | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++-----
9fc0f6
 1 file changed, 59 insertions(+), 5 deletions(-)
9fc0f6
9fc0f6
diff --git a/man/systemctl.xml b/man/systemctl.xml
9fc0f6
index 166282c..b4bc15d 100644
9fc0f6
--- a/man/systemctl.xml
9fc0f6
+++ b/man/systemctl.xml
9fc0f6
@@ -437,7 +437,7 @@ systemctl start foo
9fc0f6
 
9fc0f6
         <listitem>
9fc0f6
           <para>When used with <command>enable</command>,
9fc0f6
-          <command>disable</command>, <command>is-enabled</command>
9fc0f6
+          <command>disable</command>,
9fc0f6
           (and related commands), make changes only temporarily, so
9fc0f6
           that they are lost on the next reboot. This will have the
9fc0f6
           effect that changes are not made in subdirectories of
9fc0f6
@@ -885,10 +885,64 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
9fc0f6
 
9fc0f6
           <listitem>
9fc0f6
             <para>Checks whether any of the specified unit files are
9fc0f6
-            enabled (as with <command>enable</command>). Returns an exit
9fc0f6
-            code of 0 if at least one is enabled, non-zero
9fc0f6
-            otherwise. Prints the current enable status. To suppress
9fc0f6
-            this output, use <option>--quiet</option>.</para>
9fc0f6
+            enabled (as with <command>enable</command>). Returns an
9fc0f6
+            exit code of 0 if at least one is enabled, non-zero
9fc0f6
+            otherwise. Prints the current enable status (see table).
9fc0f6
+            To suppress this output, use <option>--quiet</option>.
9fc0f6
+            </para>
9fc0f6
+
9fc0f6
+            
9fc0f6
+              <title>
9fc0f6
+                <command>is-enabled</command> output
9fc0f6
+              </title>
9fc0f6
+
9fc0f6
+              <tgroup cols='3'>
9fc0f6
+                
9fc0f6
+                  <row>
9fc0f6
+                    <entry>Printed string</entry>
9fc0f6
+                    <entry>Meaning</entry>
9fc0f6
+                    <entry>Return value</entry>
9fc0f6
+                  </row>
9fc0f6
+                
9fc0f6
+                
9fc0f6
+                  <row>
9fc0f6
+                    <entry><literal>enabled</literal></entry>
9fc0f6
+                    <entry morerows='1'>Enabled through a symlink in <filename>.wants</filename> directory (permanently or just in <filename>/run</filename>)</entry>
9fc0f6
+                    <entry morerows='1'>0</entry>
9fc0f6
+                  </row>
9fc0f6
+                  <row>
9fc0f6
+                    <entry><literal>enabled-runtime</literal></entry>
9fc0f6
+                  </row>
9fc0f6
+                  <row>
9fc0f6
+                    <entry><literal>linked</literal></entry>
9fc0f6
+                    <entry morerows='1'>Made available through a symlink to the unit file (permanently or just in <filename>/run</filename>)</entry>
9fc0f6
+                    <entry morerows='1'>1</entry>
9fc0f6
+                  </row>
9fc0f6
+                  <row>
9fc0f6
+                    <entry><literal>linked-runtime</literal></entry>
9fc0f6
+                  </row>
9fc0f6
+                  <row>
9fc0f6
+                    <entry><literal>masked</literal></entry>
9fc0f6
+                    <entry morerows='1'>Disabled entirely (permanently or just in <filename>/run</filename>)</entry>
9fc0f6
+                    <entry morerows='1'>1</entry>
9fc0f6
+                  </row>
9fc0f6
+                  <row>
9fc0f6
+                    <entry><literal>masked-runtime</literal></entry>
9fc0f6
+                  </row>
9fc0f6
+                  <row>
9fc0f6
+                    <entry><literal>static</literal></entry>
9fc0f6
+                    <entry>Unit is not enabled, but has no provisions for enabling in [Install] section</entry>
9fc0f6
+                    <entry>1</entry>
9fc0f6
+                  </row>
9fc0f6
+                  <row>
9fc0f6
+                    <entry><literal>disabled</literal></entry>
9fc0f6
+                    <entry>Unit is not enabled</entry>
9fc0f6
+                    <entry>1</entry>
9fc0f6
+                  </row>
9fc0f6
+                
9fc0f6
+              </tgroup>
9fc0f6
+            
9fc0f6
+
9fc0f6
           </listitem>
9fc0f6
         </varlistentry>
9fc0f6