From 977c7a7c4a01ba3fad919d20404865144417d9f6 Mon Sep 17 00:00:00 2001
From: Simon McVittie <simon.mcvittie@collabora.co.uk>
Date: Tue, 17 May 2011 17:06:21 +0100
Subject: [PATCH] Describe conventional naming of methods and signals

---
 doc/dbus-specification.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 40455139..6d2b26a4 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -1290,6 +1290,14 @@
 	    <listitem><para>Must be at least 1 byte in length.</para></listitem>
           </itemizedlist>
         </para>
+
+        <para>
+          It is conventional for member names on D-Bus to consist of
+          capitalized words with no punctuation ("camel-case").
+          Method names should usually be verbs, such as
+          <literal>GetItems</literal>, and signal names should usually be
+          a description of an event, such as <literal>ItemsChanged</literal>.
+        </para>
       </sect3>
       <sect3 id="message-protocol-names-error">
         <title>Error names</title>