2009/dap/contacts Overview.html,1.122,1.123

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

Modified Files:
	Overview.html 
Log Message:
editorials, up to ContactAddress

Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/contacts/Overview.html,v
retrieving revision 1.122
retrieving revision 1.123
diff -u -d -r1.122 -r1.123
--- Overview.html	6 Apr 2011 13:54:28 -0000	1.122
+++ Overview.html	6 Apr 2011 14:13:05 -0000	1.123
@@ -587,60 +587,48 @@
         <h2><a>ContactName</a> interface</h2>
 
         <p>
-        The <a href='#contactname-interface'><code>ContactName</code></a> interface describes a contact's
-        name.
+          The <a>ContactName</a> interface describes a contact's name.
         </p>
 
         <dl title='[NoInterfaceObject] interface ContactName' class='idl'>
           <dt>attribute DOMString formatted</dt>
-
           <dd>
             <p>
-            This attribute contains the full name, including all the individual components such as
-            <code>givenName</code>, <code>middleName</code>, <code>familyName</code>, <code>prefix</code>,
-            <code>suffix</code> as appropriate, and formatted for display (e.g. <code>Mr. Joe Smith
-            Jr</code>).
+              This attribute contains the full name, including all the individual components such as
+              <code>givenName</code>, <code>middleName</code>, <code>familyName</code>, <code>prefix</code>,
+              <code>suffix</code> as appropriate for the user's culture, and formatted for display (e.g. <code>Mr. Joe Smith
+              Jr</code>).
             </p>
           </dd>
-
           <dt>attribute DOMString familyName</dt>
-
           <dd>
             <p>
-            This attribute contains the family name (also referred to as the last name) of this Contact.
+              This attribute contains the family name (also referred to as the last name) of this <a>Contact</a>.
             </p>
           </dd>
-
           <dt>attribute DOMString givenName</dt>
-
           <dd>
             <p>
-            This attribute contains the given name (also referred to as the first name) of this Contact.
+              This attribute contains the given name (also referred to as the first name) of this <a>Contact</a>.
             </p>
           </dd>
-
           <dt>attribute DOMString middleName</dt>
-
           <dd>
             <p>
-            This attribute contains the middle name of this Contact.
+              This attribute contains the middle name of this <a>Contact</a>.
             </p>
           </dd>
-
           <dt>attribute DOMString honorificPrefix</dt>
-
           <dd>
             <p>
-            This attribute contains the honorific prefix (or title) of this Contact. E.g. Mr. Dr. Ms.
-            Mrs.,
+              This attribute contains the honorific prefix (or title) of this <a>Contact</a>. E.g. Mr., Dr., Ms.,
+              Mrs.
             </p>
           </dd>
-
           <dt>attribute DOMString honorificSuffix</dt>
-
           <dd>
             <p>
-            This attribute contains the honorific suffix of this Contact. E.g. Jr, III, Sr.
+              This attribute contains the honorific suffix of this <a>Contact</a>. E.g. Jr, III, Sr.
             </p>
           </dd>
         </dl>
@@ -650,44 +638,37 @@
         <h2><a>ContactField</a> interface</h2>
 
         <p>
-        The ContactField interface is a reusable component that is used to support contact fields within the
-        <a href='#contact-interface'><code>Contact</code></a> interface.
+          The <a>ContactField</a> interface is a reusable component that is used to capture contact fields of the
+          <a>Contact</a> interface that have some modicum of structure.
         </p>
 
         <dl title='[NoInterfaceObject] interface ContactField' class='idl'>
           <dt>attribute DOMString type</dt>
-
           <dd>
             <p>
-            This attribute contains the type information for this <code>ContactField</code> and is subject
-            to the contact property this <code>ContactField</code> is representing in the <code>Contact</code>
-            interface. For example, if the <code>ContactField</code> is representing a phoneNumber property,
-            the type attribute is set to <code>home</code>, <code>mobile</code>, and if the Contact Field is
-            representing ims property, the type attribute is set to <code>yahoo</code>, <code>gtalk</code>,
-            <code>bbm</code>, etc.
+              This attribute contains the type information for this <a>ContactField</a> and its content varies subject
+              to the contact property this <a>ContactField</a> is representing. For example, if the <a>ContactField</a> 
+              is representing a <code>phoneNumber</code> property, the <code>type</code> attribute can be set to 
+              <code>home</code>, <code>mobile</code>; if the <a>ContactField</a> is representing the <code>ims</code> 
+              property, the type attribute could be set to <code>xmpp</code>, <code>irc</code>, <code>bbm</code>, etc.
             </p>
           </dd>
-
           <dt>attribute DOMString value</dt>
-
           <dd>
             <p>
-            This attribute contains the value for this <code>ContactField</code> and is subject to the
-            contact property this <code>ContactField</code> is representing in the <code>Contact</code>
-            interface. For example, if the <code>ContactField</code> is representing an <code>email</code>, the
-            value attribute is set to <var>JoeSmith@example.com</var>, and if the ContactField is representing
-            a <code>url</code>, the value attribute is set to <var>http://www.example.org/joesmith</var>,
-            etc.
+              This attribute contains the value for this <a>ContactField</a> and its content varies subject to the
+              contact property this <a>ContactField</a> is representing. For example, if the <a>ContactField</a> is 
+              representing an <code>email</code>, the value attribute could be set to <code>JoeSmith@example.com</code>, 
+              and if the <a>ContactField</a> is representing a <code>url</code>, the value attribute can be set to    
+              <code>http://www.example.org/joesmith</code>, etc.
             </p>
           </dd>
-
           <dt>attribute boolean pref</dt>
-
           <dd>
             <p>
-            This attribute indicates whether this instance of the <code>ContactField</code> is the
-            preferred, or primary, value for the contact property this <code>ContactField</code> is
-            representing in the <code>Contact</code> interface.
+              This attribute indicates whether this instance of the <a>ContactField</a> is the
+              preferred, or primary, value for the contact property this <a>ContactField</a> is
+              representing in the <a>Contact</a> interface.
             </p>
           </dd>
         </dl>
@@ -697,62 +678,46 @@
         <h2><a>ContactAddress</a> interface</h2>
 
         <p>
-        The ContactAddress interface is a reusable component that is used to support contact addresses
-        within the <a href='#contact-interface'><code>Contact</code></a> interface.
+          The <a>ContactAddress</a> interface is a reusable component that is used to capture addresses
+          within the <a>Contact</a> interface.
         </p>
-
         <dl title='[NoInterfaceObject] interface ContactAddress' class='idl'>
           <dt>attribute DOMString formatted</dt>
-
           <dd>
             <p>
-            This attribute contains the full physical address including street, locality, region,
-            postalCode, and country as appropriate, and formatted for display.
+              This attribute contains the full physical address including <code>street</code>, <code>locality</code>, 
+              <code>region</code>, <code>postalCode</code>, and <code>country</code> as appropriate, and formatted for
+              display.
             </p>
           </dd>
-
           <dt>attribute DOMString streetAddress</dt>
-
           <dd>
             <p>
-            This attribute contains the street address corresponding to this <a href=
-            "#contactaddress-interface"><code>ContactAddress</code></a>.
+              This attribute contains the street address corresponding to this <a>ContactAddress</a>.
             </p>
           </dd>
-
           <dt>attribute DOMString locality</dt>
-
           <dd>
             <p>
-            This attribute contains the locality (or city) name corresponding to this <a href=
-            "#contactaddress-interface"><code>ContactAddress</code></a>.
+              This attribute contains the locality (or city) name corresponding to this <a>ContactAddress</a>.
             </p>
           </dd>
-
           <dt>attribute DOMString region</dt>
-
           <dd>
             <p>
-            This attribute contains the region (or state/province) name corresponding to this <a href=
-            "#contactaddress-interface"><code>ContactAddress</code></a>.
+              This attribute contains the region (or state/province) name corresponding to this <a>ContactAddress</a>.
             </p>
           </dd>
-
           <dt>attribute DOMString postalCode</dt>
-
           <dd>
             <p>
-            This attribute contains the postal code (or zip) corresponding to this <a href=
-            "#contactaddress-interface"><code>ContactAddress</code></a>.
+              This attribute contains the postal code (or zip) corresponding to this <a>ContactAddress</a>.
             </p>
           </dd>
-
           <dt>attribute DOMString country</dt>
-
           <dd>
             <p>
-            This attribute contains the country name corresponding to this <a href=
-            "#contactaddress-interface"><code>ContactAddress</code></a>.
+              This attribute contains the country name corresponding to this <a>ContactAddress</a>.
             </p>
           </dd>
         </dl>

Received on Wednesday, 6 April 2011 14:13:09 UTC