From: Václav Pavlín <vpavlin@redhat.com>
Date: Thu, 31 Oct 2013 13:36:41 +0000 (+0100)
Subject: man: explain NAME in systemctl man page
X-Git-Tag: v209~1691
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=c9197a76ae552991b99673d104019e0940d6ad84

man: explain NAME in systemctl man page
---

diff --git a/man/systemctl.xml b/man/systemctl.xml
index be6b5ea1f..605b7869b 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -63,6 +63,19 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     introspect and control the state of the
     <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
     system and service manager.</para>
+
+    <para>For Unit Commands the <replaceable>NAME</replaceable> represents full name of unit.
+    <programlisting>
+systemctl start foo.service
+    </programlisting>
+    For Unit File Commands the <replaceable>NAME</replaceable> represents full name of the unit file, or absolute path to the unit file.
+    <programlisting>
+systemctl start /path/to/foo.service
+    </programlisting>
+    While working with services/service files, <command>systemctl</command> is able to append .service suffix when it is missing.
+    <programlisting>
+systemctl start foo
+    </programlisting></para>
   </refsect1>
 
   <refsect1>