From c2d6824232e8dbb182c9a57ec382ed8da8be5fa2 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] spec: briefly describe Name, Exec and User keys

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608
Reviewed-by: Chengwei Yang <chengwei.yang@intel.com>
---
 doc/dbus-specification.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index e6e75fde9..51d6cb6fb 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -4662,6 +4662,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>
@@ -4672,6 +4677,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
-- 
2.47.3