[systemd-devel] [PATCH] man: be even more clear about ExecStart's first argument

[Max Albrecht]

hi,

here is some systemd beginners feedback, in form of a small patch.
I was able to do everything I want just by reading the man pages (very refreshing).
The only thing I stumbled upon was the the requirement of the ExecStart directive, namely that is has to start with an absolute path.
Yes, of course it is mentioned in man systemd.service, but it is kind of burried in the end of a paragraph about variables.
So i propose to mention it clearly in the first paragraph.

Greetings, 

 Max
(not on the list)


Signed-off-by: Max F. Albrecht <1 at 178.is>
---
 man/systemd.service.xml | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index aecf9c6..57a3c67 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -298,8 +298,9 @@
                                 <term><varname>ExecStart=</varname></term>
                                 <listitem><para>Commands with their
                                 arguments that are executed when this
-                                service is started.
-                                </para>
+                                service is started. The first 
+                                argument must be an absolute path 
+                                name.</para>
 
                                 <para>When
                                 <varname>Type=oneshot</varname> is
@@ -357,10 +358,10 @@
                                 case it will be replaced by the value
                                 of the environment variable split up
                                 at whitespace, resulting in no or more
-                                arguments. Note that the first
-                                argument (i.e. the program to execute)
-                                may not be a variable, and must be a
-                                literal and absolute path
+                                arguments. Note that the first 
+                                argument (i.e. the program to execute) 
+                                may not be a variable, since it must 
+                                be a literal and absolute path 
                                 name.</para>
 
                                 <para>Optionally, if the absolute file
-- 
1.8.1.2


-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 1805 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/systemd-devel/attachments/20130220/0839b0db/attachment.bin>