hal: Branch 'master'

[David Zeuthen]

 doc/spec/hal-spec-examples.xml |   16 +++++++++++++---
 1 files changed, 13 insertions(+), 3 deletions(-)

New commits:
diff-tree cf5cb809dffe8bbfb25ec90a54c38b0bbe5b4b99 (from 8e2dd8e15febac3b6d7a21f87992b035fa171a73)
Author: Patrice Dumas <pertusus at free.fr>
Date:   Thu Feb 15 15:03:50 2007 -0500

    mention libhal in the docs
    
    > > Something unrelated is that I believe it would be nice to have, in
    > > the section 4 of the HAL 0.5.9 Specification a mention of libhal and
    > > a brief explanation of what it is.
    >
    > Yes, that document needs some love. We take patches though :-)
    
    Here it is. I don't really know the docbook language, so this may
    need corrections. And I am not an english natie speaker.

diff --git a/doc/spec/hal-spec-examples.xml b/doc/spec/hal-spec-examples.xml
index 4157a64..e931631 100644
--- a/doc/spec/hal-spec-examples.xml
+++ b/doc/spec/hal-spec-examples.xml
@@ -114,12 +114,22 @@
       GDL (global device list) and first then it becomes ''visible'' for
       desktop applications.
     </para>
-
+    <para>
+      Using D-BUS terminology, the HAL daemon provides the D-BUS
+      service <literal>org.freedesktop.Hal</literal>. This service may
+      be used to communicate with the HAL daemon, to get or set device
+      properties and to perform some action on the devices. In the 
+      following sections, this D-BUS interface is expanded.
+    </para>
+    <para>
+      A <literal>C</literal> API is provided by the libhal library.
+      This API hides most of the D-BUS complexity and presents the D-BUS 
+      interface as function call or callbacks.
+    </para>
     <sect2>
       <title>Interface org.freedesktop.Hal.Manager</title>
       <para>
-        Using D-BUS terminology, the HAL daemon provides the D-BUS
-        service <literal>org.freedesktop.Hal</literal>. This service
+        The <literal>org.freedesktop.Hal</literal> D-BUS service
         offers a D-BUS object at a well-known
         location <literal>/org/freedesktop/Hal/Manager</literal>. This
         object offers a D-BUS