2009/dap/system-info Overview.html,1.114,1.115

Update of /sources/public/2009/dap/system-info
In directory hutz:/tmp/cvs-serv29160/system-info

Modified Files:
	Overview.html 
Log Message:
Removed MAC, SSID, IP address, mcc, mnc
Also fixed bunch of suggestions from Dom.

Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/system-info/Overview.html,v
retrieving revision 1.114
retrieving revision 1.115
diff -u -d -r1.114 -r1.115
--- Overview.html	27 May 2010 11:53:05 -0000	1.114
+++ Overview.html	31 May 2010 06:47:34 -0000	1.115
@@ -17,7 +17,7 @@
           noIDLSorting: true,
           noIDLIn: true,
           editors: [{name:"Max Froumentin",company:"Opera Software ASA",companyURL:"http://www.opera.com"},
-                    {name:"Dzung Tran",company:"Intel",companyURL:"http://intel.com"}]
+                    {name:"Dzung D Tran",company:"Intel",companyURL:"http://intel.com"}]
       };
     </script>
     <script src='../common/config.js' class='remove'></script>
@@ -99,9 +99,11 @@
 
         <p>The name of a property (or its URI, interchangeably) is
         used in the functions of the <a>SystemInfo</a> interface to
-        identify the accessed property. In response to calling one of
-        those functions, the resulting property MUST be an instance of
-        the property’s interface i.e. an instance of the webIDL
+        identify the accessed property. The name of a property or its URI 
+        are equivalent for identifying the property. Character-per-character comparison 
+        will be used while matching for property, without any normalization. 
+        In response to calling one of those functions, the resulting property MUST 
+        be an instance of the property's interface i.e. an instance of the webIDL
         interface that contains its attributes.</p>
 
         <p>Some of the properties below are defined as
@@ -177,7 +179,7 @@
               <dt>SuccessCB successCallback</dt>
               <dd>Function called when the properties have been successfully retrieved.</dd>
 
-              <dt>optional ErrorCB? errorCallback</dt>
+              <dt>optional ErrorCB errorCallback</dt>
               <dd>Function called when an error occurred while retrieving the properties.</dd>
 
               <dt>optional Options options</dt>
@@ -221,7 +223,7 @@
             <dd>Property URI or name identifying the property to track.</dd>
             <dt>SuccessCB successCallback</dt>
             <dd>Function called when the properties have been successfully retrieved.</dd>
-            <dt>optional ErrorCB? errorCallback</dt>
+            <dt>optional ErrorCB errorCallback</dt>
             <dd>Function called when an error occurred while retrieving the properties.</dd>
             <dt>optional Options options</dt>
             <dd>An object containing the various options for fetching the properties requested.</dd>
@@ -271,14 +273,14 @@
         <section>
           <h2>The Error interface</h2>
           <dl title='[NoInterfaceObject] interface Error' class='idl'>
-            <dt>const unsigned short PERMISSION_DENIED = 0</dt>
+            <dt>const unsigned short PERMISSION_DENIED = 1</dt>
             <dd>The application context does not have permission to
             access this property.</dd>
 
-            <dt>const unsigned short INFORMATION_UNAVAILABLE = 1</dt>
+            <dt>const unsigned short INFORMATION_UNAVAILABLE = 2</dt>
             <dd>The property accessed is either unknown or unavailable on this device (e.g. the battery level on a device that only has an external power source).</dd>
             
-            <dt>const unsigned short INVALID_VALUE = 2</dt>
+            <dt>const unsigned short INVALID_VALUE = 3</dt>
             <dd>One or more of the values in the <a>Options</a>
             object passed was invalid. For example, if the
             <a>highThreshold</a> attribute is set to a value
@@ -300,12 +302,6 @@
         <section>
           <h2>The <a>Options</a> interface</h2>
           <dl title="[NoInterfaceObject] interface Options" class="idl">
-            <dt>attribute unsigned long timeout</dt>
-            
-            <dd>The number of milliseconds beyond which the operation
-            must be interrupted and the <a>cancel()</a> method of
-            the <a>PendingOp</a> object must be called.</dd>
-            
             <dt>attribute double highThreshold</dt>
             <dd>This attribute has no effect on the <a>get()</a>
             method. On the <a>monitor()</a> method, it indicates that
@@ -335,7 +331,7 @@
             agent MUST call the error callback with the
             <a>INVALID_VALUE</a> code.</dd>
 
-            <dt>attribute long timeout</dt>
+            <dt>attribute unsigned long timeout</dt>
             <dd>The <a>timeout</a> attribute denotes the maximum
             length of time (expressed in milliseconds) that is allowed
             to pass from the call to <a>monitor()</a> until the
@@ -575,7 +571,7 @@
 
           <dl title='[NoInterfaceObject] interface ConnectionAttributes : SystemProperty' class='idl'>
 
-            <dt>attribute String type</dt>
+            <dt>attribute DOMString type</dt>
             <dd>The type of network connection. The value is one of 
               <ul>
                 <li>"<code>Unknown</code>" if the type of this connection is unknown.</li>
@@ -617,29 +613,12 @@
             offered by this network connection, measured in
             Kbits/s.</dd>
 
-            <dt>attribute DOMString macAddress</dt>
-            <dd>The <abbr title="Media Access Control">MAC</abbr>
-            address of this connection. The format of this string MUST
-            be the standard notation for MAC addresses: six groups of
-            two hexadecimal digits, separated by colons (:),
-            e.g. 01:23:45:67:89:ab [[!IEEE802-3]].</dd>
-
-            <dt>attribute DOMString ipAddress</dt>
-            <dd>The IP Address assigned to the device by the network
-            bearer.</dd>
-
             <dt>attribute float currentSignalStrength</dt>
             <dd>This connection's signal strength, as a normalized
             value between 0 (no signal detected) and 1 (the level is
             at its maximum value).  This attribute can be used as a
             <a>threshold target</a>.</dd>
 
-            <dt>attribute DOMString? SSID</dt>
-            <dd>The Service Set Identifier (SSID) of this
-            connection. A value of <code>null</code> indicates that
-            this property is not applicable to this connection
-            type.</dd>
-
             <dt>attribute DOMString apn</dt>
             <dd>The Access Point Name associated to a network bearer.</dd>
 
@@ -651,14 +630,6 @@
             <code>true</code> indicates that the connection is
             roaming, while <code>false</code> indicates that it
             is not roaming.</dd>
-
-            <dt>attribute unsigned short mcc</dt>
-            <dd>This connection's <em>mobile country code</em>, as
-            defined by [[!ITUMCC]].</dd>
-
-            <dt>attribute unsigned short mnc</dt>
-            <dd>This connection's <em>mobile network code</em>, as
-            defined by [[!ITUMNC]].</dd>
           </dl>
         </section>
       </section>
@@ -679,7 +650,7 @@
 navigator.system.monitor("AmbientLight",success, null, {highThreshold: 0.9, thresholdTarget:"normalizedValue"});
 
 function success() { 
-  setColorScheme('bright');
+  setColorScheme('bright');  // user-defined function to set color scheme of the desktop
 }
 </pre>
         </section>
@@ -882,18 +853,18 @@
 
           <dl title='[NoInterfaceObject] interface VideoCodecAttributes : SystemProperty' class='idl'>
               
-            <dt>attribute DOMString compFormats[]</dt>
+            <dt>attribute DOMString[] compFormats</dt>
             <dd>Supported compression format names, e.g. "H.264" or "Theora".</dd>
-            <dt>attribute DOMString containerFormats[]</dt>
+            <dt>attribute DOMString[] containerFormats</dt>
             <dd>Supported container format names, e.g. "AVI", "Ogg".</dd>
             <dt>attribute boolean hwAccel</dt>
             <dd><code>true</code> if the codec includes hardware acceleration support, <code>false</code> otherwise.</dd>
-            <dt>attribute DOMString profiles[]</dt>
+            <dt>attribute DOMString[] profiles</dt>
             <dd>The list of profiles available for this codec. For
             example, "Simple", "Main", "High" or "Advanced".</dd>
-            <dt>attribute DOMString frameTypes[]</dt>
+            <dt>attribute DOMString[] frameTypes</dt>
             <dd>The list of frame types supported by the codec. For example, "Progressive" or "Interlaced".</dd>
-            <dt>attribute DOMString rateTypes[]</dt>
+            <dt>attribute DOMString[] rateTypes</dt>
             <dd>The list of rate control options supported by the codec. For example, "CBR" or "VBR".</dd>
           </dl>
         </section>
@@ -956,7 +927,7 @@
               <dd><a>type</a> is set to this value if the device uses solid-state RAM technology, e.g. chip or memory card.</dd>
               <dt>attribute unsigned short type</dt>
               <dd>The type of pointing device. The value is one of the constants defined for this attribute.</dd>
-              <dt>attribute boolean isReadWrite</dt>
+              <dt>attribute boolean isWritable</dt>
               <dd><code>true</code> if this device supports software modification, <code>else</code> otherwise.</dd>
               <dt>attribute unsigned long capacity</dt>
               <dd>The amount of data that this device can hold, in bytes. A <a>monitor()</a> operation acting on an object of type <a>StorageUnit</a> must invoke the success callback only if this attribute has changed.</dd>
@@ -1048,7 +1019,7 @@
               <dd>The display's physical width in centimeters.</dd>
               <dt>attribute float physicalHeight</dt>
               <dd>The display's physical height in centimeters.</dd>
-              <dt>attribute String? info</dt>
+              <dt>attribute DOMString? info</dt>
               <dd>Free-form text description of the device.</dd>
             </dl>
 
@@ -1072,7 +1043,7 @@
             <dd>Frequency range, high value, in Hz.</dd>
             <dt>attribute unsigned short volumeLevel</dt>
             <dd>The volume level of a speaker, on a 0 to 100 scale.</dd>
-            <dt>attribute String? info</dt>
+            <dt>attribute DOMString? info</dt>
             <dd>Free-form text description of the device.</dd>
           </dl>
 
@@ -1101,7 +1072,7 @@
             <dt>attribute boolean color</dt>
             <dd><code>true</code> is this printer is able to print in color, <code>false</code> otherwise.</dd>
 
-            <dt>attribute String? info</dt>
+            <dt>attribute DOMString? info</dt>
             <dd>Free-form text description of the device.</dd>
           </dl>
 
@@ -1109,7 +1080,7 @@
           <dl title="[NoInterfaceObject] interface BrailleDeviceAttributes" class="idl">
             <dt>attribute unsigned long nbCells</dt>
             <dd>The number of cells on this device.</dd>
-            <dt>attribute String? info</dt>
+            <dt>attribute DOMString? info</dt>
             <dd>Free-form text description of the device.</dd>
           </dl>
           
@@ -1185,7 +1156,7 @@
               <dd>The type of pointing device. The value is one of the constants defined for this type.</dd>
               <dt>attribute boolean supportsMultiTouch</dt>
               <dd><code>true</code> if this device supports the multi-touch method of interaction, <code>else</code> otherwise.</dd>
-              <dt>attribute String? info</dt>
+              <dt>attribute DOMString? info</dt>
               <dd>Free-form text description of the device.</dd>
             </dl>
 
@@ -1203,7 +1174,7 @@
               <dd>The type of pointing device. The value is one of the constants defined for this type.</dd>
               <dt>attribute boolean isHardware</dt>
               <dd><code>true</code> if this device is a physical keyboard, <code>else</code> if it is a software keyboard.</dd>
-              <dt>attribute String? info</dt>
+              <dt>attribute DOMString? info</dt>
               <dd>Free-form text description of the device.</dd>
             </dl>
             
@@ -1243,7 +1214,7 @@
               <dd>Frequency range, low value, in Hz.</dd>
               <dt>attribute unsigned long freqRangeHigh</dt>
               <dd>Frequency range, high value, in Hz.</dd>
-              <dt>attribute String? info</dt>
+              <dt>attribute DOMString? info</dt>
               <dd>Free-form text description of the device.</dd>
             </dl>
           </section>

Received on Monday, 31 May 2010 06:47:38 UTC