From: Sven Herzberg <sven@imendio.com>
Date: Thu, 7 Apr 2011 17:25:34 +0000 (+0100)
Subject: list which parts of the Desktop Entry spec apply to service files
X-Git-Tag: dbus-1.4.8~3
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=136b8b8c86ac3499a5a7385081a9d0b21fc181f9;p=platform%2Fupstream%2Fdbus.git

list which parts of the Desktop Entry spec apply to service files

Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=19159
---

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index ee5aac5..54d3c46 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -39,6 +39,16 @@
           </address>
 	</affiliation>
       </author>
+      <author>
+	<firstname>Sven</firstname>
+	<surname>Herzberg</surname>
+	<affiliation>
+	  <orgname>Imendio AB</orgname>
+	  <address>
+            <email>sven@imendio.com</email>
+          </address>
+	</affiliation>
+      </author>
     </authorgroup>
    <revhistory>
      <revision>
@@ -3781,9 +3791,7 @@
         <xref linkend="message-bus-types"/>.
       </para>
       <para>
-        [FIXME the file format should be much better specified than "similar to
-        .desktop entries" esp. since desktop entries are already
-        badly-specified. ;-)] Service description files have the ".service" file
+        Service description files have the ".service" file
         extension. The message bus will only load service description files
         ending with .service; all other files will be ignored.  The file format
         is similar to that of <ulink
@@ -3793,6 +3801,17 @@
         must be namespaced using the same mechanism as messages and service
         names.
 
+      <para>
+        [FIXME the file format should be much better specified than "similar to
+        .desktop entries" esp. since desktop entries are already
+        badly-specified. ;-)]
+        These sections from the specification apply to service files as well:
+
+        <itemizedlist>
+          <listitem><para>General syntax</para></listitem>
+          <listitem><para>Comment format</para></listitem>
+        </itemizedlist>
+
         <figure>
 	  <title>Example service description file</title>
 	  <programlisting>