9fc0f6
From bc7d6c8e11a22d29b14b6070117f261961eadb23 Mon Sep 17 00:00:00 2001
9fc0f6
From: =?UTF-8?q?V=C3=A1clav=20Pavl=C3=ADn?= <vpavlin@redhat.com>
9fc0f6
Date: Thu, 31 Oct 2013 14:36:41 +0100
9fc0f6
Subject: [PATCH] man: explain NAME in systemctl man page
9fc0f6
9fc0f6
---
9fc0f6
 man/systemctl.xml | 13 +++++++++++++
9fc0f6
 1 file changed, 13 insertions(+)
9fc0f6
9fc0f6
diff --git a/man/systemctl.xml b/man/systemctl.xml
9fc0f6
index e789d4b..166282c 100644
9fc0f6
--- a/man/systemctl.xml
9fc0f6
+++ b/man/systemctl.xml
9fc0f6
@@ -63,6 +63,19 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
9fc0f6
     introspect and control the state of the
9fc0f6
     <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
9fc0f6
     system and service manager.</para>
9fc0f6
+
9fc0f6
+    <para>For Unit Commands the <replaceable>NAME</replaceable> represents full name of unit.
9fc0f6
+    <programlisting>
9fc0f6
+systemctl start foo.service
9fc0f6
+    </programlisting>
9fc0f6
+    For Unit File Commands the <replaceable>NAME</replaceable> represents full name of the unit file, or absolute path to the unit file.
9fc0f6
+    <programlisting>
9fc0f6
+systemctl start /path/to/foo.service
9fc0f6
+    </programlisting>
9fc0f6
+    While working with services/service files, <command>systemctl</command> is able to append .service suffix when it is missing.
9fc0f6
+    <programlisting>
9fc0f6
+systemctl start foo
9fc0f6
+    </programlisting></para>
9fc0f6
   </refsect1>
9fc0f6
 
9fc0f6
   <refsect1>