bindings in libhal for Mount, Umount...?

[Patrice Dumas]

On Thu, Feb 08, 2007 at 11:05:56AM -0500, David Zeuthen wrote:
> 
> > 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.

--
Pat
-------------- next part --------------
# Updated but not checked in:
#   (will commit)
#
#	modified:   doc/spec/hal-spec-examples.xml
#
# Untracked files:
#   (use "git add" to add to commit)
#
#	hal-spec-examples.xml-libhal.diff
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