- From: Robin Berjon via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 19 Jul 2011 12:04:14 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/contacts In directory hutz:/tmp/cvs-serv25455/contacts Modified Files: Overview.html Log Message: remove caller Index: Overview.html =================================================================== RCS file: /sources/public/2009/dap/contacts/Overview.html,v retrieving revision 1.148 retrieving revision 1.149 diff -u -d -r1.148 -r1.149 --- Overview.html 29 Jun 2011 07:50:35 -0000 1.148 +++ Overview.html 19 Jul 2011 12:04:12 -0000 1.149 @@ -324,11 +324,11 @@ <a href='#widl-Contact-categories'><code>categories</code></a> values as part of individual <a>Contact</a> objects. Multiple contact groups can be displayed by filtering on the required <a href='#widl-Contact-categories'><code>categories</code></a> values via - the <a>Contacts</a> <a href='#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options'>find()</a> operation. + the <a>Contacts</a> <a href='#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options'>find()</a> operation. </p> <dl title='[NoInterfaceObject] interface Contacts' class='idl'> - <dt>caller void find ()</dt> + <dt>void find ()</dt> <dd> <p> Find contacts in the address book according to the <a>find contacts process</a> detailed @@ -733,7 +733,7 @@ <h2><a>ContactFindOptions</a> interface</h2> <p> The <a>ContactFindOptions</a> interface describes the options that can be applied to contact searching. - When a <a>ContactFindOptions</a> parameter is provided to the <a>Contacts</a> <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> + When a <a>ContactFindOptions</a> parameter is provided to the <a>Contacts</a> <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation, it should be processed according to the provisions detailed in <a href="#options-processing">Options Processing</a>. </p> @@ -745,7 +745,7 @@ <dt>attribute boolean? multiple</dt> <dd> A boolean value to indicate whether multiple Contact objects are wanted as part of the - <a>Contacts</a> <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. + <a>Contacts</a> <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. By default this option is set to <code>false</code>. </dd> </dl> @@ -754,7 +754,7 @@ <section> <h2><a>ContactFindCB</a> interface</h2> <p> - This is the wrapper interface for callbacks indicating success of the <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> + This is the wrapper interface for callbacks indicating success of the <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. </p> @@ -765,7 +765,7 @@ <dt>Contact[] contactObjs</dt> <dd> An array of <a>Contact</a> objects resulting from the given <a>Contacts</a> - <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. + <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. </dd> </dl> </dd> @@ -797,7 +797,7 @@ <section> <h2><a>ContactErrorCB</a> interface</h2> <p> - This is the wrapper interface for callbacks indicating failure of the <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> + This is the wrapper interface for callbacks indicating failure of the <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. </p> @@ -876,7 +876,7 @@ <h2><a>Contact Search Processing</a></h2> <p> - The <a href="#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> + The <a href="#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> method provides an operation to search for one of more <a href= "#contact-interface"><code>Contact</code></a> objects within the <a href= "#contacts-interface"><code>Contacts</code></a> database. @@ -891,18 +891,18 @@ successful callback. The <a>search qualifier</a> is deployed to minimize the data that needs to be shared with an application in order to let that application fulfill its function on behalf of the user. The <a>search qualifier</a> is included within a <a href= - "#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation as + "#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation as the <code>fields</code> parameter. </p> <p id="ta-aj" class="product-ua"> A <a>search qualifier</a> MUST be specified from a requesting application as a part of any <a href= - "#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. + "#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. </p> <p id="ta-ab" class="product-ua"> If the <a>search qualifier</a> provided is of <em>zero-length</em> then the current <a href= - "#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation and + "#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation and the current find() operation was invoked with a non-<code>null</code> <code>errorCB</code> parameter, then the user agent MUST invoke the <code>errorCB</code> function with an error code of <a href= @@ -912,7 +912,7 @@ <p id="ta-ak" class="product-ua"> In the case that the <a>search qualifier</a> provided is of <em>non-zero-length</em> then the current <a href="#contacts-interface"><code>Contacts</code></a> <a href= - "#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation MUST return only the matching <a href= + "#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation MUST return only the matching <a href= "#contact-interface"><code>Contact</code></a> properties within any resulting <a href= "#contact-interface"><code>Contact</code></a> object(s). </p> @@ -921,7 +921,7 @@ If a provided <a>search qualifier</a> element (<code>fields[x]</code>) does not match a <a href= "#contact-interface"><code>Contact</code></a> attribute, <code>fields[x]</code> SHOULD be ignored when executing the current <a href="#contacts-interface"><code>Contacts</code></a> <a href= - "#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. + "#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. </p> <section> @@ -938,7 +938,7 @@ "#contact-interface"><code>Contact</code></a> attribute and also be able to request individual parts of a composed <a href="#contact-interface"><code>Contact</code></a> attribute in the <a>search qualifier</a> provided to a <a href="#contacts-interface"><code>Contacts</code></a> <a href= - "#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. + "#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. </p> <p> @@ -949,7 +949,7 @@ of this composed attribute (i.e. <code>name.formatted</code>, <code>name.familyName</code>, <code>name.givenName</code>, <code>name.middleName</code>, <code>name.honorificPrefix</code>, <code>name.honorificSuffix</code>) as part of a <a href= - "#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation's + "#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation's <a>search qualifier</a>. </p> @@ -1005,7 +1005,7 @@ <p id="ta-am" class="product-ua"> By default, the <a href="#contacts-interface"><code>Contacts</code></a> <a href= - "#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation MUST return either an empty sequence or a single <a href= + "#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation MUST return either an empty sequence or a single <a href= "#contact-interface"><code>Contact</code></a> object, accessible as part of the sequence returned in the <a href="#contactfindcb-interface"><code>ContactFindCB</code></a> callback function. </p> @@ -1013,9 +1013,9 @@ <p id="ta-ae" class="product-ua"> If a <a href="#contactfindoptions-interface"><code>ContactFindOptions</code></a> object is provided to the <a href="#contacts-interface"><code>Contacts</code></a> <a href= - "#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation and its <code>multiple</code> attribute is set to + "#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation and its <code>multiple</code> attribute is set to <code>true</code>, the <a href="#contacts-interface"><code>Contacts</code></a> <a href= - "#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation MUST return either an empty sequence, a single <a href= + "#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation MUST return either an empty sequence, a single <a href= "#contact-interface"><code>Contact</code></a> object or <var>[X]</var> number of <a href= "#contact-interface"><code>Contact</code></a> objects, accessible as part of the sequence returned in the <a href="#contactfindcb-interface"><code>ContactFindCB</code></a> callback function. @@ -1031,7 +1031,7 @@ <p>The <a>search filter</a> is defined through the <code>filter</code> attribute of the <a href="#contactfindoptions-interface"><code>ContactFindOptions</code></a> object provided to a <a href="#contacts-interface"><code>Contacts</code></a> <a href= - "#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. + "#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation. </p> <p>The actual usage of this <a>search filter</a> is user-agent dependant, but is expected to represent @@ -1537,7 +1537,7 @@ <p> To update an existing Contact, the user must have already shared the contact information to edit - with the current web page via the <a href='#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options'>find()</a> operation of the <a href= + with the current web page via the <a href='#widl-Contacts-find-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options'>find()</a> operation of the <a href= "#contacts-interface"><code>Contacts</code></a> interface. This section assumes that the user is already sharing some contact information with the current web page via this process. </p>
Received on Tuesday, 19 July 2011 12:04:16 UTC