hal: Branch 'master'

[David Zeuthen]

 doc/spec/hal-spec-introduction.xml |   29 +++++++++++++++++++++++------
 1 files changed, 23 insertions(+), 6 deletions(-)

New commits:
diff-tree f3d4d470bfaa221038ee400166d43fbdbe8ec165 (from c82997e6bc2ca71aceffc27951747855ab9ab3d7)
Author: David Zeuthen <davidz at redhat.com>
Date:   Sun Mar 25 13:31:09 2007 -0400

    more spec changes

diff --git a/doc/spec/hal-spec-introduction.xml b/doc/spec/hal-spec-introduction.xml
index 90ab644..5a9873c 100644
--- a/doc/spec/hal-spec-introduction.xml
+++ b/doc/spec/hal-spec-introduction.xml
@@ -202,10 +202,10 @@
       the operating system kernel, such as SCSI emulation for USB
       Storage Devices, are also considered device objects in HAL. This
       implies that operating system kernel specific bits leak into the
-      device object database. However users of HAL won't notice, such
-      device objects are not referenced anywhere in the device objects
-      that users are interested in; they are merely used as glue to
-      build the device tree.
+      device object database. However applications using HAL will not
+      notice this, such device objects are not referenced anywhere in
+      the device objects that users are interested in; they are merely
+      used as glue to build the device tree.
     </para>
     <para>
       In addition to provide information about what kind of hardware a
@@ -230,7 +230,13 @@
       for details.
     </para>
     <para>
-      An HAL device object is comprised by
+      Finally, HAL provides one or more <emphasis>D-Bus
+      interfaces</emphasis> for applications to configure and/or use
+      the device. These interfaces are discussed in
+      <xref linkend="interfaces"/>.
+    </para>
+    <para>
+      Summarizing, a device object is comprised by
     </para>
     <itemizedlist>
       <listitem>
@@ -254,7 +260,8 @@
         <para>
           Each device object got a set of properties which are
           key/value pairs.  The key is an ASCII string while the value
-          can be one of several types
+          can be one of several types, see below. Properties are
+          arranged into name spaces using ''.'' as a separator.
           <itemizedlist>
             <listitem>
               <para>
@@ -290,6 +297,16 @@
           </itemizedlist>
         </para>
       </listitem>
+      <listitem>
+        <para>
+          <emphasis>Interfaces</emphasis>
+        </para>
+        <para>
+          Applications can configure and/or use a device using D-Bus
+          interfaces. Typically, there's a one-to-one relationship
+          between capabilities/namespaces and interfaces.
+        </para>
+      </listitem>
     </itemizedlist>
     <para>
       Properties of a device object carry all the important