[Telepathy-commits] [telepathy-doc/master] docs/book/C/telepathy.xml: Using D-Bus: Add a <note> about the generated numeric Bus Names, based on some text from Davyd's branch. I fear that it's an unnecessary distraction for Telepathy users, but it would be nice for this section to be generically useful outside of Telepathy.

[Murray Cumming]

---
 ChangeLog                 |    8 ++++++++
 docs/book/C/telepathy.xml |    2 ++
 2 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 2d579ef..de69186 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,13 @@
 2009-02-03  Murray Cumming  <murrayc at openismus.com>
 
+	* docs/book/C/telepathy.xml: Using D-Bus: Add a <note> about the 
+	generated numeric Bus Names, based on some text from Davyd's branch.
+	I fear that it's an unnecessary distraction for Telepathy users, but it 
+	would be nice for this section to be generically useful outside of 
+	Telepathy.  
+
+2009-02-03  Murray Cumming  <murrayc at openismus.com>
+
 	* docs/book/C/telepathy.xml: Basics: Moved the Using D-Bus section 
 	into its own chapter because it has become too big. Mention it in the 
 	initial paragraph of the Basics chapter. Move the Language Bindings 
diff --git a/docs/book/C/telepathy.xml b/docs/book/C/telepathy.xml
index b062ebb..83af1c5 100644
--- a/docs/book/C/telepathy.xml
+++ b/docs/book/C/telepathy.xml
@@ -216,6 +216,8 @@ of the Telapathy specification.
 
     <para>Of course, for simple services with just one object that provides just one interface, these three names will often look very similar.</para>
 
+    <note><para>As well as a <literal>Bus Name</literal>, every D-Bus service is also available via a generated <literal>Unique Name</literal>. This is an identifier assigned to a client by the D-Bus daemon (such as &quot;:1.3&quot;). The <literal>Unique Name</literal> is analagous to an IP address in computer networking, while the <literal>Bus Name</literal> is analogous to a DNS name. You are unlikely to deal with <literal>Bus Name</literal>s when using Telepathy.</para></note>
+
     <para>In the following sections you will see how a D-Bus API can be used from some common programming languages. Remember that these examples only create <literal>proxies</literal> to the D-Bus objects, providing a way to use their API. The actual objects are instantiated in the service's process.</para>
 
     <para>In these examples, we use the FreeDesktop <literal>Notification</literal> system, which should be available on most modern Linux installations. The examples should cause a message to popup from your desktop panel. Note that, like Telepathy, this service is available on the <indexterm><primary>Session Bus</primary></indexterm><literal>Session Bus</literal> rather than the <indexterm><primary>System Bus</primary></indexterm><literal>System Bus</literal>. Services on the <literal>Session Bus</literal> are for the current user's session only. Services on the <literal>System Bus</literal> are shared between all users.</para>
-- 
1.5.6.5