Attachment 46825 Details for Bug 37095 – [PATCH 6/9] Briefly mention why to namespace object-paths

[patch] [PATCH 6/9] Briefly mention why to namespace object-paths

0006-Briefly-mention-why-to-namespace-object-paths.patch (text/plain), 1.71 KB, created by Simon McVittie on 2011-05-17 09:13:03 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2011-05-17 09:13:03 UTC

Size: 1.71 KB

patch

obsolete

>From dd2b63e6e1fa4d773645a94f31709bd0a6eb0152 Mon Sep 17 00:00:00 2001
>From: Simon McVittie <simon.mcvittie@collabora.co.uk>
>Date: Tue, 17 May 2011 17:06:46 +0100
>Subject: [PATCH 6/9] Briefly mention why to namespace object-paths
>
>---
> doc/dbus-specification.xml |   22 +++++++++++++++++++++-
> 1 files changed, 21 insertions(+), 1 deletions(-)
>
>diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
>index 20b0d48..ea72752 100644
>--- a/doc/dbus-specification.xml
>+++ b/doc/dbus-specification.xml
>@@ -762,9 +762,29 @@
>           </itemizedlist>
>         </para>
> 
>+        <para>
>+          Object paths are often namespaced by starting with a reversed
>+          domain name and containing an interface version number, in the
>+          same way as
>+          <link linkend="message-protocol-names-interface">interface
>+            names</link> and
>+          <link linkend="message-protocol-names-bus">well-known
>+            bus names</link>.
>+          This makes it possible to implement more than one service, or
>+          more than one version of a service, in the same process,
>+          even if the services share a connection but cannot otherwise
>+          co-operate (for instance, if they are implemented by different
>+          plugins).
>+        </para>
>+
>+        <para>
>+          For instance, if the owner of <literal>example.com</literal> is
>+          developing a D-Bus API for a music player, they might use the
>+          hierarchy of object paths that start with
>+          <literal>/com/example/MusicPlayer1</literal> for its objects.
>+        </para>
>       </sect3>
> 
>-      
>       <sect3 id="message-protocol-marshaling-signature">
>         <title>Valid Signatures</title>
>         <para>
>-- 
>1.7.5.1
>

Actions: View | Splinter Review

Attachments on bug 37095: 46820 | 46821 | 46822 | 46823 | 46824 | 46825 | 46826 | 46827 | 46828 | 126931

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.