hal: Branch 'master'

[Danny Kukawka]

 doc/spec/hal-spec-properties.xml |   73 ++++++++++++++++++++++++---------------
 1 files changed, 45 insertions(+), 28 deletions(-)

New commits:
diff-tree 3a56233f78b98c460b81589022ffc1b22a08cfd7 (from b26ba073131b944b9ad3760ecc7b60834ee585a0)
Author: Danny Kukawka <danny.kukawka at web.de>
Date:   Fri Feb 9 19:54:11 2007 +0100

    added new section for deprecated properties to spec
    
    Added a new section to spec to collect information about deprecated
    properties. The new table provide info about the deprecated key, the
    key which replace the deprecated one (if there is on), the earliest
    possible date for complete deletion of the property and a column for
    note/explanation.
    
    Added info for info.bus, *.physical_device and the deprecated
    power_management.can_suspend_to_* keys to the new section.

diff --git a/doc/spec/hal-spec-properties.xml b/doc/spec/hal-spec-properties.xml
index 214ffa9..3a5813e 100644
--- a/doc/spec/hal-spec-properties.xml
+++ b/doc/spec/hal-spec-properties.xml
@@ -5592,34 +5592,6 @@
             </row>
             <row>
               <entry>
-                <literal>power_management.can_suspend_to_ram</literal> (bool)
-              </entry>
-              <entry></entry>
-              <entry>No</entry>
-              <entry>
-                If suspend support is compiled into the kernel.
-                NB. This may not mean the machine is able to suspend
-                successfully.
-                WARNING: This key is depreciated and power_management.can_suspend
-                should be used in its place. This key will be removed, but not before May 1st 2007.
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <literal>power_management.can_suspend_to_disk</literal> (bool)
-              </entry>
-              <entry></entry>
-              <entry>No</entry>
-              <entry>
-                If hibernation support is compiled into the kernel.
-                NB. This may not mean the machine is able to hibernate
-                successfully.
-                WARNING: This key is depreciated and power_management.can_hibernate
-                should be used in its place. This key will be removed, but not before May 1st 2007.
-              </entry>
-            </row>
-            <row>
-              <entry>
                 <literal>power_management.is_powersave_set</literal> (bool)
               </entry>
               <entry/>
@@ -6222,5 +6194,50 @@
       </informaltable>
     </sect2>
   </sect1>
+  <sect1 id="properties-deprecated">
+    <title>Deprecated Properties</title>
+    <para>
+      The section represents properties that are deprecated and should be no longer used. 
+      The properties/keys will be removed, but not before the date in the following table:
+    </para>
+      <informaltable>
+        <tgroup cols="2">
+          <thead>
+            <row>
+              <entry>Key (type)</entry>
+              <entry>Replacement</entry>
+              <entry>Remove (date)</entry>
+              <entry>Notes</entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry><literal>info.bus</literal> (string)</entry>
+              <entry><literal>info.bus</literal></entry>
+              <entry>2008-03-01</entry>
+              <entry>Renamed to something more abstract, available until removed.</entry>
+            </row>
+            <row>
+              <entry><literal>*.physical_device</literal> (string)</entry>
+              <entry><literal>*.originating_device</literal></entry>
+              <entry>2008-03-01</entry>
+              <entry>Renamed to something more abstract, available until removed.</entry>
+            </row>
+            <row>
+              <entry><literal>power_management.can_suspend_to_ram</literal> (bool)</entry>
+              <entry><literal>power_management.can_suspend</literal></entry>
+              <entry>2007-05-01</entry>
+              <entry></entry>
+            </row>
+            <row>
+              <entry><literal>power_management.can_suspend_to_disk</literal> (bool)</entry>
+              <entry><literal>power_management.can_hibernate</literal></entry>
+              <entry>2007-05-01</entry>
+              <entry></entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </informaltable>
+  </sect1>
 
 </chapter>