hal/doc/spec hal-spec.xml.in,1.44,1.45

[Richard Hughes]

Update of /cvs/hal/hal/doc/spec
In directory gabe:/tmp/cvs-serv18211

Modified Files:
	hal-spec.xml.in 
Log Message:
Add description of the key battery.charge_level.percentage and explain why it's sometimes missing.
Also modified description of battery.remaining_time explaining the different meanings while charging and discharging.

Index: hal-spec.xml.in
===================================================================
RCS file: /cvs/hal/hal/doc/spec/hal-spec.xml.in,v
retrieving revision 1.44
retrieving revision 1.45
diff -u -d -r1.44 -r1.45
--- hal-spec.xml.in	5 Aug 2005 10:57:21 -0000	1.44
+++ hal-spec.xml.in	19 Aug 2005 19:31:02 -0000	1.45
@@ -4232,8 +4232,19 @@
               <entry>No</entry>
               <entry>
 		Remaining time, in seconds, that the battery can provide
-		power if it's discharging. This is an estimate and may be
-		imprecise.
+		power (if discharging) or the time until charged (if charging). 
+		This is an estimate and may be imprecise.
+		This key is not present for invalid data.
+	      </entry>
+	    </row>
+	    <row>
+              <entry><literal>battery.charge_level.percentage</literal> (int)</entry>
+              <entry></entry>
+              <entry>No</entry>
+              <entry>
+		Charge, normalised to percent. This is useful if an application
+		does not want to process the raw values and do all the extra
+		checks on the result. This key is not present for invalid data.
 	      </entry>
 	    </row>
             <row>