From 762596b3cc2e0e9504cead8a6c8a9113d075224b Mon Sep 17 00:00:00 2001
From: Simon McVittie <simon.mcvittie@collabora.co.uk>
Date: Mon, 16 Sep 2013 14:36:21 +0100
Subject: [PATCH 4/4] spec: briefly describe Name, Exec and User keys

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608
---
 doc/dbus-specification.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index b89631a..2075b61 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -4675,6 +4675,11 @@
           <listitem><para>Comment format</para></listitem>
         </itemizedlist>
 
+        Service description files must contain a
+        <literal>D-BUS Service</literal> group with at least the keys
+        <literal>Name</literal> (the well-known name of the service)
+        and <literal>Exec</literal> (the command to be executed).
+
         <figure>
 	  <title>Example service description file</title>
 	  <programlisting>
@@ -4685,6 +4690,14 @@
           </programlisting>
 	</figure>
       </para>
+
+      <para>
+        Additionally, service description files for the well-known system
+        bus on Unix must contain a <literal>User</literal> key, whose value
+        is the name of a user account (e.g. <literal>root</literal>).
+        The system service will be run as that user.
+      </para>
+
       <para>
         When an application asks to start a service by name, the bus daemon tries to
         find a service that will own that name. It then tries to spawn the
-- 
1.8.4.rc3