2009/dap/contacts Overview.html,1.58,1.59

Update of /sources/public/2009/dap/contacts
In directory hutz:/tmp/cvs-serv12661/contacts

Modified Files:
	Overview.html 
Log Message:
[POCO-SCHEMA] references made normative.

Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/contacts/Overview.html,v
retrieving revision 1.58
retrieving revision 1.59
diff -u -d -r1.58 -r1.59
--- Overview.html	15 Jun 2010 22:48:34 -0000	1.58
+++ Overview.html	16 Jun 2010 10:56:09 -0000	1.59
@@ -135,9 +135,7 @@
         </div>
 <pre
  class='example sh_javascript_dom'>
-// previous example follow-on...
-
-// Create new contact   
+// Create new contact  
 var myContact = navigator.service.contacts.create({displayName: &#39;Robert&#39;}});
 
 // Add additional contact attributes as required...
@@ -200,7 +198,7 @@
         to this API to reflect requirements or support for privacy-related functionality.
       </p>
       <p>
-        The API defined in this specification can be used to create, retrieve, update and remove contact information from a user&#39;s
+        The API defined in this specification can be used to create, find, save and remove contact information from a user&#39;s
         address book(s). All API methods disclose information related to a user&#39;s contacts such as their phone number(s), email
         address(es) and other personally identifying information. The distribution of this information could potentially compromise the
         user&#39;s privacy. A conforming implementation of this specification MUST provide a mechanism that protects the user&#39;s privacy
@@ -212,7 +210,7 @@
           Privacy considerations for implementors of the Contacts API
         </h2>
         <p>
-          A <a>user agent</a> must not create, retrieve, update or delete contact information to Web sites without the express permission
+          A <a>user agent</a> must not create, find, save or delete contact information to Web sites without the express permission
           of the user. A <a>user agent</a> must acquire permission through a user interface, unless they have prearranged trust
           relationships with users, as described below. The user interface must include the URI of the document origin, as defined in
           [[HTML5]]. Those permissions that are acquired through the user interface and that are preserved beyond the current browsing
@@ -223,7 +221,7 @@
           Obtaining the user&#39;s express permission to access one API method does not imply the user has granted permission for the same
           Web site to access other methods provided by this API, or to access the same method with a different set of arguments, as part of
           the same permission context. If a user has expressed permission for an implementation to, e.g. find a set of existing contacts,
-          the implementation must seek the user&#39;s express permission if and when any additional create, find, update or remove function
+          the implementation must seek the user&#39;s express permission if and when any additional create, find, save or remove function
           is called on this API.
         </p>
         <p>
@@ -448,7 +446,7 @@
               Address Book.
             </p>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>id</code>] for additional definition of this attribute.
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>id</code>] for additional definition of this attribute.
             </p>
           </dd>
           <dt>
@@ -626,11 +624,11 @@
         <p>
           The <a
            href="#contactproperties-interface"><code>ContactProperties</code></a> interface captures the settable properties of a contact.
-          All properties included in this interface have a corresponding definition in [[POCO-SCHEMA]].
+          All properties included in this interface have a corresponding definition in [[!POCO-SCHEMA]].
         </p>
         <p>
           In addition to the properties defined in this interface, a conforming implementation MUST supported both the Singular and Plural
-          OpenSocial fields defined in [[POCO-SCHEMA]].
+          OpenSocial fields defined in [[!POCO-SCHEMA]].
         </p>
         <dl
          title='[NoInterfaceObject] interface ContactProperties'
@@ -640,7 +638,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>displayName</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>displayName</code>].
             </p>
           </dd>
           <dt>
@@ -648,7 +646,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>name</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>name</code>].
             </p>
           </dd>
           <dt>
@@ -656,7 +654,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>nickname</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>nickname</code>].
             </p>
           </dd>
           <dt>
@@ -664,7 +662,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>phoneNumbers</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>phoneNumbers</code>].
             </p>
           </dd>
           <dt>
@@ -672,7 +670,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>emails</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>emails</code>].
             </p>
           </dd>
           <dt>
@@ -680,7 +678,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>addresses</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>addresses</code>].
             </p>
           </dd>
           <dt>
@@ -688,7 +686,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>ims</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>ims</code>].
             </p>
           </dd>
           <dt>
@@ -696,7 +694,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>organizations</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>organizations</code>].
             </p>
           </dd>
           <dt>
@@ -704,7 +702,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>published</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>published</code>].
             </p>
           </dd>
           <dt>
@@ -712,7 +710,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>updated</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>updated</code>].
             </p>
           </dd>
           <dt>
@@ -720,7 +718,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>birthday</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>birthday</code>].
             </p>
           </dd>
           <dt>
@@ -728,7 +726,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>anniversary</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>anniversary</code>].
             </p>
           </dd>
           <dt>
@@ -736,7 +734,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>gender</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>gender</code>].
             </p>
           </dd>
           <dt>
@@ -744,7 +742,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>note</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>note</code>].
             </p>
           </dd>
           <dt>
@@ -752,7 +750,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>preferredUsername</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>preferredUsername</code>].
             </p>
           </dd>
           <dt>
@@ -760,7 +758,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>photos</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>photos</code>].
             </p>
           </dd>
           <dt>
@@ -768,7 +766,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>tags</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>tags</code>].
             </p>
           </dd>
           <dt>
@@ -776,7 +774,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>relationships</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>relationships</code>].
             </p>
           </dd>
           <dt>
@@ -784,7 +782,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>urls</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>urls</code>].
             </p>
           </dd>
           <dt>
@@ -792,7 +790,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.2. <code>accounts</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.2. <code>accounts</code>].
             </p>
           </dd>
           <dt>
@@ -800,7 +798,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>utcOffset</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>utcOffset</code>].
             </p>
           </dd>
           <dt>
@@ -809,10 +807,10 @@
           <dd>
             <p
              class="note">
-              Ignore this [[POCO-SCHEMA]] attribute?
+              Ignore this [[!POCO-SCHEMA]] attribute?
             </p>
             <p>
-              See [[[POCO-SCHEMA]] Section 7.2.1. <code>connected</code>].
+              See [[[!POCO-SCHEMA]] Section 7.2.1. <code>connected</code>].
             </p>
           </dd>
         </dl>
@@ -833,7 +831,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.3. <code>formatted</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.3. <code>formatted</code>].
             </p>
           </dd>
           <dt>
@@ -841,7 +839,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.3. <code>familyName</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.3. <code>familyName</code>].
             </p>
           </dd>
           <dt>
@@ -849,7 +847,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.3. <code>givenName</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.3. <code>givenName</code>].
             </p>
           </dd>
           <dt>
@@ -857,7 +855,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.3. <code>middleName</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.3. <code>middleName</code>].
             </p>
           </dd>
           <dt>
@@ -865,7 +863,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.3. <code>honorificPrefix</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.3. <code>honorificPrefix</code>].
             </p>
           </dd>
           <dt>
@@ -873,7 +871,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.3. <code>honorificSuffix</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.3. <code>honorificSuffix</code>].
             </p>
           </dd>
         </dl>
@@ -894,7 +892,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.2.2. <code>type</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.2.2. <code>type</code>].
             </p>
           </dd>
           <dt>
@@ -902,7 +900,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.2.2. <code>value</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.2.2. <code>value</code>].
             </p>
           </dd>
           <dt>
@@ -910,7 +908,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.2.2. <code>primary</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.2.2. <code>primary</code>].
             </p>
           </dd>
         </dl>
@@ -931,7 +929,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.4. <code>formatted</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.4. <code>formatted</code>].
             </p>
           </dd>
           <dt>
@@ -939,7 +937,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.4. <code>streetAddress</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.4. <code>streetAddress</code>].
             </p>
           </dd>
           <dt>
@@ -947,7 +945,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.4. <code>locality</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.4. <code>locality</code>].
             </p>
           </dd>
           <dt>
@@ -955,7 +953,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.4. <code>region</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.4. <code>region</code>].
             </p>
           </dd>
           <dt>
@@ -963,7 +961,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.4. <code>postalCode</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.4. <code>postalCode</code>].
             </p>
           </dd>
           <dt>
@@ -971,7 +969,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.4. <code>country</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.4. <code>country</code>].
             </p>
           </dd>
         </dl>
@@ -992,7 +990,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.5. <code>name</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.5. <code>name</code>].
             </p>
           </dd>
           <dt>
@@ -1000,7 +998,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.5. <code>department</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.5. <code>department</code>].
             </p>
           </dd>
           <dt>
@@ -1008,7 +1006,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.5. <code>title</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.5. <code>title</code>].
             </p>
           </dd>
           <dt>
@@ -1016,7 +1014,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.5. <code>startDate</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.5. <code>startDate</code>].
             </p>
           </dd>
           <dt>
@@ -1024,7 +1022,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.5. <code>endDate</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.5. <code>endDate</code>].
             </p>
           </dd>
           <dt>
@@ -1032,7 +1030,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.5. <code>location</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.5. <code>location</code>].
             </p>
           </dd>
           <dt>
@@ -1040,7 +1038,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.5. <code>description</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.5. <code>description</code>].
             </p>
           </dd>
         </dl>
@@ -1061,7 +1059,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.6. <code>domain</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.6. <code>domain</code>].
             </p>
           </dd>
           <dt>
@@ -1069,7 +1067,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.6. <code>username</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.6. <code>username</code>].
             </p>
           </dd>
           <dt>
@@ -1077,7 +1075,7 @@
           </dt>
           <dd>
             <p>
-              See [[[POCO-SCHEMA]]] Section 7.6. <code>userid</code>].
+              See [[[!POCO-SCHEMA]]] Section 7.6. <code>userid</code>].
             </p>
           </dd>
         </dl>

Received on Wednesday, 16 June 2010 10:56:13 UTC