- From: Richard Tibbett via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 21 Jan 2011 01:49:42 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/contacts
In directory hutz:/tmp/cvs-serv6924/contacts
Modified Files:
Overview.html
Log Message:
Added 'vCard object' as the family of vCard specs.
Removed any dependencies on a particular version of the vCard specs.
Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/contacts/Overview.html,v
retrieving revision 1.111
retrieving revision 1.112
diff -u -d -r1.111 -r1.112
--- Overview.html 19 Jan 2011 16:06:05 -0000 1.111
+++ Overview.html 21 Jan 2011 01:49:40 -0000 1.112
@@ -1466,7 +1466,7 @@
title="user agent">user agents</a> without outside registration or standardization.
</p>
<p>
- It is RECOMMENDED that authors define both a formal vCard grammar [[RFC2426]] and a WebIDL grammar [[WEBIDL]] for their proposed
+ It is RECOMMENDED that authors define both a formal vCard grammar and a WebIDL grammar for their proposed
extension to ensure interoperability between vCard databases and other non-standard Contact databases and formats. It is also
RECOMMENDED that authors provide documentation of their extension properties and parameters within the public domain.
</p>
@@ -1811,7 +1811,12 @@
<p>
A <dfn>valid Contact resource</dfn> is a web resource with a <code>.vcard</code> or <code>.vcf</code> filename extension or a web resource with a
- MIME-type matching a <a>valid media type</a>.
+ MIME-type matching a <a>valid media type</a>. A <dfn>vCard object</dfn> is a text-based representation of contact information provided according to any
+ version of the vCard family of specifications.
+ </p>
+
+ <p>
+ Need to add informative references to all specs within the 'vCard family of specifications'.
</p>
<p>
@@ -1819,10 +1824,11 @@
</p>
<p>
- A <dfn>valid media type</dfn> will be one of the following web resource MIME types:
+ A <dfn>valid media type</dfn> will be one of the following web resource MIME types:
</p>
<ul>
+ <li><code>text/vcard</code></li>
<li><code>text/x-vcard</code></li>
<li><code>text/directory</code></li>
<li><code>text/directory;profile=vCard</code></li>
@@ -1847,7 +1853,7 @@
<ol>
<li>
- If <var>Contact</var> contains a <code>UID</code> key [VCard4] then process the <a>valid Contact resource</a> as follows.
+ If <var>Contact</var> contains a <code>UID</code> key then process the <a>valid Contact resource</a> as follows.
<ol>
<li>
@@ -1878,10 +1884,10 @@
<h4>Adding a new Contact</h4>
<p>
- A web page can dynamically generate a vCard object on the client side for download to the user's unified address book via either data: URIs [[RFC2397]] or using the
- [[FILE-WRITER]] and [[FILE-API]] interfaces. The following examples show two methods for creating a vCard object
+ A web page can dynamically generate a <a>vCard object</a> on the client side for download to the user's unified address book via either data: URIs [[RFC2397]] or using the
+ [[FILE-WRITER]] and [[FILE-API]] interfaces. The following examples show two methods for creating a <a>vCard object</a>
dynamically and then presenting this to the user. The user may then save this information by clicking on the presented information, download the
- dynamically generated vCard object and invoke a suitable application with which to handle the dynamic resource.
+ dynamically generated <a>vCard object</a> and invoke a suitable application with which to handle the dynamic resource.
</p>
<div class="example">
@@ -1934,8 +1940,8 @@
<p>
If this existing Contact information is to be updated in the user's unified address book then the developer will assign the
- <code>id</code> attribute, as returned in the <code>Contact</code> object, as the <code>UID</code> property [VCard4] of any resulting
- vCard object to be processed by the <a>user agent</a> according to the <a>rule for storing a Contact resource</a>.
+ <code>id</code> attribute, as returned in the <code>Contact</code> object, as the <code>UID</code> property of any resulting
+ <a>vCard object</a> to be processed by the <a>user agent</a> according to the <a>rule for storing a Contact resource</a>.
</p>
<p>
@@ -1952,8 +1958,8 @@
var existingContactObj = ...;
var vcard = 'BEGIN:VCARD\r\n' +
- 'VERSION:2.1\r\n' +
- 'UID:' + existingContactObj.id + // assign the Contact.id to a UID property
+ 'VERSION:3.0\r\n' +
+ 'UID:' + existingContactObj.id + '\r\n' + // assign the Contact.id to a UID property
'N:Doe;John\r\n' +
'FN:John Doe\r\n' +
'TEL;HOME;VOICE:654321\r\n' +
Received on Friday, 21 January 2011 01:49:43 UTC