- From: Robin Berjon via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 15 Jun 2011 14:52:13 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/contacts/LC
In directory hutz:/tmp/cvs-serv31817/LC
Modified Files:
Overview.html
Log Message:
bad anchor
Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/contacts/LC/Overview.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- Overview.html 15 Jun 2011 14:47:50 -0000 1.1
+++ Overview.html 15 Jun 2011 14:52:11 -0000 1.2
@@ -775,12 +775,12 @@
<a href="#widl-Contact-categories"><code>categories</code></a> values as part of individual
<a class="idlType" href="#idl-def-Contact"><code>Contact</code></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 class="idlType" href="#idl-def-Contacts"><code>Contacts</code></a> <a href="#widl-Contacts-find">find()</a> operation.
+ the <a class="idlType" href="#idl-def-Contacts"><code>Contacts</code></a> <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation.
</p>
<pre class="idl"><span class="idlInterface" id="idl-def-Contacts">[<span class="extAttr">NoInterfaceObject</span>]
interface <span class="idlInterfaceID">Contacts</span> {
-<span class="idlMethod"> <span class="idlMethType"><a>caller void</a></span> <span class="idlMethName"><a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find</a></span> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a>[]</span> <span class="idlParamName">fields</span></span>, <span class="idlParam"><span class="idlParamType"><a class="idlType" href="#idl-def-ContactFindCB"><code>ContactFindCB</code></a></span> <span class="idlParamName">successCB</span></span>, <span class="idlParam">optional <span class="idlParamType"><a class="idlType" href="#idl-def-ContactErrorCB"><code>ContactErrorCB</code></a></span> <span class="idlParamName">errorCB</span></span>, <span class="idlParam">optional <span class="idlParamType"><a class="idlType" href="#idl-def-ContactFindOptions"><code>ContactFindOptions</code></a></span> <span class="idlParamName">options</span></span>);</span>
+<span class="idlMethod"> <span class="idlMethType"><a>caller void</a></span> <span class="idlMethName"><a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find</a></span> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a>[]</span> <span class="idlParamName">fields</span></span>, <span class="idlParam"><span class="idlParamType"><a class="idlType" href="#idl-def-ContactFindCB"><code>ContactFindCB</code></a></span> <span class="idlParamName">successCB</span></span>, <span class="idlParam">optional <span class="idlParamType"><a class="idlType" href="#idl-def-ContactErrorCB"><code>ContactErrorCB</code></a></span> <span class="idlParamName">errorCB</span></span>, <span class="idlParam">optional <span class="idlParamType"><a class="idlType" href="#idl-def-ContactFindOptions"><code>ContactFindOptions</cde></a></span> <span class="idlParamName">options</span></span>);</span>
};</span>
</pre><div class="section" id="methods"><h4><span class="secno">4.2.1 </span>Methods</h4><dl class="methods"><dt id="widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options"><code>find</code></dt><dd>
<p>
@@ -1150,7 +1150,7 @@
<h3><span class="secno">4.8 </span><a class="idlType" href="#idl-def-ContactFindOptions"><code>ContactFindOptions</code></a> interface</h3>
<p>
The <a class="idlType" href="#idl-def-ContactFindOptions"><code>ContactFindOptions</code></a> interface describes the options that can be applied to contact searching.
- When a <a class="idlType" href="#idl-def-ContactFindOptions"><code>ContactFindOptions</code></a> parameter is provided to the <a class="idlType" href="#idl-def-Contacts"><code>Contacts</code></a> <a href="#widl-Contacts-find">find()</a>
+ When a <a class="idlType" href="#idl-def-ContactFindOptions"><code>ContactFindOptions</code></a> parameter is provided to the <a class="idlType" href="#idl-def-Contacts"><code>Contacts</code></a> <a href="#widl-Contacts-find-caller-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>
@@ -1163,7 +1163,7 @@
A string-based <a class="internalDFN" href="#dfn-search-filter">search filter</a> which provides a hint to the user agent to facilitate contacts selection by the user.
<div><em>No exceptions.</em></div></dd><dt id="widl-ContactFindOptions-multiple"><code>multiple</code> of type <span class="idlAttrType"><a>boolean</a></span>, nullable</dt><dd>
A boolean value to indicate whether multiple Contact objects are wanted as part of the
- <a class="idlType" href="#idl-def-Contacts"><code>Contacts</code></a> <a href="#widl-Contacts-find">find()</a> operation.
+ <a class="idlType" href="#idl-def-Contacts"><code>Contacts</code></a> <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation.
By default this option is set to <code>false</code>.
<div><em>No exceptions.</em></div></dd></dl></div>
</div>
@@ -1171,7 +1171,7 @@
<div class="section" id="contactfindcb-interface">
<h3><span class="secno">4.9 </span><a class="idlType" href="#idl-def-ContactFindCB"><code>ContactFindCB</code></a> interface</h3>
<p>
- This is the wrapper interface for callbacks indicating success of the <a href="#widl-Contacts-find">find()</a>
+ 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>
operation.
</p>
@@ -1183,7 +1183,7 @@
<table class="parameters"><tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr><tr><td class="prmName">contactObjs</td><td class="prmType"><code><a class="idlType" href="#idl-def-Contact"><code>Contact</code></a>[]</code></td><td class="prmNullFalse">✘</td><td class="prmOptFalse">✘</td><td class="prmDesc">
An array of <a class="idlType" href="#idl-def-Contact"><code>Contact</code></a> objects resulting from the given <a class="idlType" href="#idl-def-Contacts"><code>Contacts</code></a>
- <a href="#widl-Contacts-find">find()</a> operation.
+ <a href="#widl-Contacts-find-caller-void-DOMStringArray-fields-ContactFindCB-successCB-ContactErrorCB-errorCB-ContactFindOptions-options">find()</a> operation.
</td></tr></table><div><em>No exceptions.</em></div><div><em>Return type: </em><code><a>void</a></code></div></dd></dl></div>
<div class="section" id="event-handler-attributes">
@@ -1212,7 +1212,7 @@
<div class="section" id="contacterrorcb-interface">
<h3><span class="secno">4.10 </span><a class="idlType" href="#idl-def-ContactErrorCB"><code>ContactErrorCB</code></a> interface</h3>
<p>
- This is the wrapper interface for callbacks indicating failure of the <a href="#widl-Contacts-find">find()</a>
+ 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>
operation.
</p>
@@ -1276,7 +1276,7 @@
<!--OddPage--><h2><span class="secno">5. </span><a>Contact Search Processing</a></h2>
<p>
- The <a href="#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find">find()</a>
+ 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>
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.
</p>
@@ -1288,16 +1288,16 @@
<a href="#contact-interface"><code>Contact</code></a> properties it wishes to obtain in any resulting
successful callback. The <a class="internalDFN" href="#dfn-search-qualifier">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 class="internalDFN" href="#dfn-search-qualifier">search qualifier</a> is included within a <a href="#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find">find()</a> operation as
+ The <a class="internalDFN" href="#dfn-search-qualifier">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
the <code>fields</code> parameter.
</p>
<p id="ta-aj" class="product-ua">
- A <a class="internalDFN" href="#dfn-search-qualifier">search qualifier</a> <em title="must" class="rfc2119">must</em> be specified from a requesting application as a part of any <a href="#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find">find()</a> operation.
+ A <a class="internalDFN" href="#dfn-search-qualifier">search qualifier</a> <em title="must" class="rfc2119">must</em> 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.
</p>
<p id="ta-ab" class="product-ua">
- If the <a class="internalDFN" href="#dfn-search-qualifier">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">find()</a> operation and
+ If the <a class="internalDFN" href="#dfn-search-qualifier">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
the current find() operation was invoked with a non-<code>null</code>
<code>errorCB</code> parameter, then the user agent <em title="must" class="rfc2119">must</em> invoke the <code>errorCB</code> function
with an error code of <a href="#widl-ContactError-INVALID_ARGUMENT_ERROR"><code>INVALID_ARGUMENT_ERROR</code></a>.
@@ -1305,12 +1305,12 @@
<p id="ta-ak" class="product-ua">
In the case that the <a class="internalDFN" href="#dfn-search-qualifier">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">find()</a> operation <em title="must" class="rfc2119">must</em> 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).
+ 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 <em title="must" class="rfc2119">must</em> 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>
<p id="ta-al" class="product-ua">
If a provided <a class="internalDFN" href="#dfn-search-qualifier">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> <em title="should" class="rfc2119">should</em> be ignored when
- executing the current <a href="#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find">find()</a> operation.
+ 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.
</p>
<div class="section" id="advanced-search-qualifiers">
@@ -1325,7 +1325,7 @@
<p class="product-ua" id="ta-ad">
A requesting application <em title="must" class="rfc2119">must</em> be able to request both the full composed <a href="#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 class="internalDFN" href="#dfn-search-qualifier">search
- qualifier</a> provided to a <a href="#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find">find()</a> operation.
+ 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.
</p>
<p>
@@ -1333,7 +1333,7 @@
request either the full composed attribute (i.e. <code>name</code>) or specific individual attributes
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">find()</a> operation's
+ <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
<a class="internalDFN" href="#dfn-search-qualifier">search qualifier</a>.
</p>
@@ -1385,14 +1385,14 @@
<h4><span class="secno">5.2.1 </span>Search Cardinality</h4>
<p id="ta-am" class="product-ua">
- By default, the <a href="#contacts-interface"><code>Contacts</code></a> <a href="#widl-Contacts-find">find()</a> operation <em title="must" class="rfc2119">must</em> 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
+ 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 <em title="must" class="rfc2119">must</em> 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>
<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">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">find()</a> operation <em title="must" class="rfc2119">must</em> 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
+ 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
+ <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 <em title="must" class="rfc2119">must</em> 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.
</p>
</div>
@@ -1405,7 +1405,7 @@
<p>The <a class="internalDFN" href="#dfn-search-filter">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">find()</a> operation.
+ 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.
</p>
<p>The actual usage of this <a class="internalDFN" href="#dfn-search-filter">search filter</a> is user-agent dependant, but is expected to represent
@@ -1892,7 +1892,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">find()</a> operation of the <a href="#contacts-interface"><code>Contacts</code></a> interface. This section assumes that the user is
+ 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="#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 Wednesday, 15 June 2011 14:52:15 UTC