hal: Branch 'master'

[Dan Williams]

 doc/spec/hal-spec-properties.xml |   57 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

New commits:
commit 9cece37fd82df82d24744d21fce693ba4eefa447
Author: Dan Williams <dcbw at redhat.com>
Date:   Fri Feb 15 17:30:38 2008 -0500

    add a 'modem' capability and namespace
    
    Serial devices that are known to be modems should get the 'modem'
    capability and populate the 'modem.command_sets' list with the
    command sets they support as listed in the HAL specification.
    
    See the following mail threads for more details:
    
    http://lists.freedesktop.org/archives/hal/2008-February/010759.html
    http://lists.freedesktop.org/archives/hal/2008-February/010780.html

diff --git a/doc/spec/hal-spec-properties.xml b/doc/spec/hal-spec-properties.xml
index 45889c7..877ea5f 100644
--- a/doc/spec/hal-spec-properties.xml
+++ b/doc/spec/hal-spec-properties.xml
@@ -881,6 +881,63 @@ org.freedesktop.Hal.Device.Volume.method_signatures = {'ssas', 'as', 'as'}
         </tgroup>
       </informaltable>
     </sect2>
+    <sect2 id="device-properties-modemif">
+      <title>
+        modem namespace
+      </title>
+      <para>
+        Serial device objectes that are known to be modems should also gain the
+        <literal>modem</literal> capability in their
+        <literal>info.capabilities</literal> list.  Modem device objects must
+        also be serial device objects.
+      </para>
+      <informaltable>
+        <tgroup cols="2">
+          <thead>
+            <row>
+              <entry>Key (type)</entry>
+              <entry>Values</entry>
+              <entry>Mandatory</entry>
+              <entry>Description</entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry>
+                <literal>modem.command_sets</literal> (string)
+              </entry>
+              <entry>example: GSM-07.07, GSM-07.05</entry>
+              <entry>Yes</entry>
+              <entry>This property defines the command sets the modem device supports.</entry>
+            </row>
+            <row>
+              <entry></entry>
+              <entry>IS-707-A</entry>
+              <entry>Yes</entry>
+              <entry>This modem supports the IS-707-A standard AT commands (commonly used by CDMA cellular devices).  Implies V.250 support.</entry>
+            </row>
+            <row>
+              <entry></entry>
+              <entry>GSM-07.07</entry>
+              <entry>Yes</entry>
+              <entry>This modem supports the GSM-07.07 standard AT commands (commonly used by GSM-based cellular devices).  Implies V.250 support.</entry>
+            </row>
+            <row>
+              <entry></entry>
+              <entry>GSM-07.05</entry>
+              <entry>Yes</entry>
+              <entry>This modem supports the GSM-07.05 standard AT commands (commonly used by GSM-based cellular devices).  Implies V.250 support.</entry>
+            </row>
+            <row>
+              <entry></entry>
+              <entry>ITU-V.250</entry>
+              <entry>Yes</entry>
+              <entry>This modem supports the ITU V.250 standard AT commands (also known as Hayes-compatible).</entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </informaltable>
+    </sect2>
     <sect2 id="device-properties-usb">
       <title>
         usb_device namespace