W3C home > Mailing lists > Public > public-html-diffs@w3.org > May 2009

Changed HTMLPropertyCollection to always return PropertyNodeLists when accessed by name. Make itemprop=about only work for RDF on the linking elements. vCard output support. Minor tweaks to microdata. Editorial fixes. (whatwg r3105)

From: poot <cvsmail@w3.org>
Date: Mon, 18 May 2009 19:27:46 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20090518102746.51FD82BBE7@toro.w3.mag.keio.ac.jp>
Changed HTMLPropertyCollection to always return PropertyNodeLists when
accessed by name. Make itemprop=about only work for RDF on the linking
elements. vCard output support. Minor tweaks to microdata. Editorial
fixes. (whatwg r3105)

Diffs for this change per section: 
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#extracting-a-vcard
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#vevent
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#converting-html-to-other-formats
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#editor-s-draft-date-1-january-1970
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#examples-0
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#propertyvaluearray
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#vcard-0
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#icalendar
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#alphanumeric-ascii-characters
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#collecting-vcard-subproperties
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#dom-htmlpropertycollection-nameditem
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#escaping-the-vcard-text-string
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#using-the-microdata-dom-api
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#json
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#values
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#generate-the-triples-for-an-item
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#add-a-vcard-line
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#collecting-the-first-vcard-subproperty
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#md-vcard-n
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#dom-htmlpropertycollection-length
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#md-vevent-attach
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#dom-propertynodelist-content
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#htmlpropertycollection-0
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#status-of-this-document
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#a-vocabulary-and-associated-apis-for-html-and-xhtml
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#propertynodelist
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#dom-htmlpropertycollection-names
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#rdf
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#dom-htmlpropertycollection-item
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#microdata-dom-api
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#url-property-elements
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#htmlpropertycollection
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2263.html#white_space

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2262&r2=1.2263&f=h
http://html5.org/tools/web-apps-tracker?from=3104&to=3105

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2262
retrieving revision 1.2263
diff -u -d -r1.2262 -r1.2263
--- Overview.html	15 May 2009 00:36:53 -0000	1.2262
+++ Overview.html	16 May 2009 02:02:52 -0000	1.2263
@@ -152,7 +152,7 @@
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
    <!--ZZZ:-->
    <!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>-->
-   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 15 May 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 16 May 2009</h2>
    <!--:ZZZ-->
    <dl><!-- ZZZ: update the month/day (twice), (un)comment out
     <dt>This Version:</dt>
@@ -245,7 +245,7 @@
   track.
   <!--ZZZ:-->
   <!--This specification is the 23 April 2009 Working Draft.-->
-  This specification is the 15 May 2009 Editor's Draft.
+  This specification is the 16 May 2009 Editor's Draft.
   <!--:ZZZ-->
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href="http://www.whatwg.org/">WHATWG</a>. The two specifications are
   identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -1912,6 +1912,11 @@
   <p>The <dfn id="white_space" title="White_Space">White_Space characters</dfn> are
   those that have the Unicode property "White_Space". <a href="#references">[UNICODE]</a></p>
 
+  <p>The <dfn id="alphanumeric-ascii-characters">alphanumeric ASCII characters</dfn> are those in the
+  ranges U+0030 DIGIT ZERO .. U+0039 DIGIT NINE, U+0041 LATIN CAPITAL
+  LETTER A .. U+005A LATIN CAPITAL LETTER Z, U+0061 LATIN SMALL LETTER
+  A .. U+007A LATIN SMALL LETTER Z.</p>
+
   <p>Some of the micro-parsers described below follow the pattern of
   having an <var title="">input</var> variable that holds the string
   being parsed, and having a <var title="">position</var> variable
@@ -5909,15 +5914,16 @@
   model.<pre class="idl">[Callable=<a href="#dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem">namedItem</a>]
 interface <dfn id="htmlpropertycollection-0">HTMLPropertyCollection</dfn> {
   readonly attribute unsigned long <a href="#dom-htmlpropertycollection-length" title="dom-HTMLPropertyCollection-length">length</a>;
-  readonly attribute <span>DOMStringList</span> <a href="#dom-htmlpropertycollection-names" title="dom-HTMLPropertyCollection-names">names</a>;
   [IndexGetter] <a href="#htmlelement">HTMLElement</a> <a href="#dom-htmlpropertycollection-item" title="dom-HTMLPropertyCollection-item">item</a>(in unsigned long index);
-  [NameGetter] Object <a href="#dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem">namedItem</a>(in DOMString name);
+
+  readonly attribute <span>DOMStringList</span> <a href="#dom-htmlpropertycollection-names" title="dom-HTMLPropertyCollection-names">names</a>;
+  [NameGetter] <a href="#propertynodelist">PropertyNodeList</a> <a href="#dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem">namedItem</a>(in DOMString name);
 };
 
-typedef sequence&lt;DOMString&gt; <dfn id="domstringarray">DOMStringArray</dfn>;
+typedef sequence&lt;any&gt; <dfn id="propertyvaluearray">PropertyValueArray</dfn>;
 
 interface <dfn id="propertynodelist">PropertyNodeList</dfn> : <span>NodeList</span> {
-          attribute <a href="#domstringarray">DOMStringArray</a> <a href="#dom-propertynodelist-content" title="dom-PropertyNodeList-content">content</a>;
+          attribute <a href="#propertyvaluearray">PropertyValueArray</a> <a href="#dom-propertynodelist-content" title="dom-PropertyNodeList-content">content</a>;
 };</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLPropertyCollection-length"><a href="#dom-htmlpropertycollection-length">length</a></code></dt>
    <dd>
     <p>Returns the number of elements in the collection.</p>
@@ -5940,9 +5946,7 @@
    <dt><var title="">collection</var>[<var title="">name</var>]</dt>
    <dt><var title="">collection</var>(<var title="">name</var>)</dt>
    <dd>
-    <p>Returns the element with that adds the property named <var title="">name</var> from the collection.</p>
-    <p>If there are multiple matching elements, then a <code><a href="#propertynodelist">PropertyNodeList</a></code> object containing all those elements is returned.</p>
-    <p>Returns null if no element adds the property named <var title="">name</var>.</p>
+    <p>Returns a <code><a href="#propertynodelist">PropertyNodeList</a></code> object containing any elements that add a property named <var title="">name</var>.</p>
    </dd>
 
    <dt><var title="">propertyNodeList</var> . <var title="">content</var></dt>
@@ -5965,14 +5969,6 @@
   attribute must return the number of nodes <a href="#represented-by-the-collection">represented by the
   collection</a>.</p>
 
-  <p>The <dfn id="dom-htmlpropertycollection-names" title="dom-HTMLPropertyCollection-names"><code>names</code></dfn>
-  attribute must return a live <code>DOMStringList</code> object
-  giving the <a href="#property-names">property names</a> of all the elements
-  <a href="#represented-by-the-collection">represented by the collection</a>, listed in <a href="#tree-order">tree
-  order</a>, but with duplicates removed, leaving only the first
-  occurrence of each name. The same object must be returned each
-  time.</p>
-
   <p>The <dfn id="dom-htmlpropertycollection-item" title="dom-HTMLPropertyCollection-item"><code>item(<var title="">index</var>)</code></dfn> method must return the <var title="">index</var>th node in the collection. If there is no <var title="">index</var>th node in the collection, then the method must
   return null.</p>
 
@@ -5980,32 +5976,31 @@
   of the <a href="#property-names">property names</a> of all the elements
   <a href="#represented-by-the-collection">represented by the collection</a>.</p>
 
-  <p>The <dfn id="dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem"><code>namedItem(<var title="">name</var>)</code></dfn> method must act according to the
-  following algorithm:</p>
-
-  <ol><li>If, at the time the method is called, there is exactly one node
-   in the collection that has a <a href="#property-names" title="property names">property
-   name</a> equal to <var title="">name</var>, then return that
-   node and stop the algorithm.</li>
-
-   <li>Otherwise, if there are no nodes in the collection that have a
-   <a href="#property-names" title="property names">property name</a> equal to <var title="">name</var>, then return null and stop the algorithm.</li>
-
-   <li>Otherwise, create a <code><a href="#propertynodelist">PropertyNodeList</a></code> object
-   representing a live view of the <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code>
-   object, further filtered so that the only nodes in the
-   <code><a href="#radionodelist">RadioNodeList</a></code> object are those that have a <a href="#property-names" title="property names">property name</a> equal to <var title="">name</var>. The nodes in the <code><a href="#propertynodelist">PropertyNodeList</a></code>
-   object must be sorted in <a href="#tree-order">tree order</a>.</li>
+  <p>The <dfn id="dom-htmlpropertycollection-names" title="dom-HTMLPropertyCollection-names"><code>names</code></dfn>
+  attribute must return a live <code>DOMStringList</code> object
+  giving the <a href="#property-names">property names</a> of all the elements
+  <a href="#represented-by-the-collection">represented by the collection</a>, listed in <a href="#tree-order">tree
+  order</a>, but with duplicates removed, leaving only the first
+  occurrence of each name. The same object must be returned each
+  time.</p>
 
-   <li>Return that <code><a href="#propertynodelist">PropertyNodeList</a></code> object.</li>
+  <p>The <dfn id="dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem"><code>namedItem(<var title="">name</var>)</code></dfn> method must return a
+  <code><a href="#propertynodelist">PropertyNodeList</a></code> object representing a live view of the
+  <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code> object, further filtered so that
+  the only nodes in the <code><a href="#radionodelist">RadioNodeList</a></code> object are those
+  that have a <a href="#property-names" title="property names">property name</a> equal
+  to <var title="">name</var>. The nodes in the
+  <code><a href="#propertynodelist">PropertyNodeList</a></code> object must be sorted in <a href="#tree-order">tree
+  order</a>, and the same object must be returned each time a
+  particular <var title="">name</var> is queried.</p>
 
-  </ol><hr><p>A members of the <code><a href="#propertynodelist">PropertyNodeList</a></code> interface
+  <hr><p>A members of the <code><a href="#propertynodelist">PropertyNodeList</a></code> interface
   inherited from the <code>NodeList</code> interface must behave as
   they would on a <code>NodeList</code> object.</p>
 
   <p>The <dfn id="dom-propertynodelist-content" title="dom-PropertyNodeList-content"><code>content</code></dfn> DOM
   attribute on the <code><a href="#propertynodelist">PropertyNodeList</a></code> object, on getting,
-  must return a newly constructed <code><a href="#domstringarray">DOMStringArray</a></code> whose
+  must return a newly constructed <code>DOMStringArray</code> whose
   values are the values obtained from the <code title="dom-content"><a href="#dom-content">content</a></code> DOM property of each of the
   elements represented by the object, in <a href="#tree-order">tree order</a>.</p>
 
@@ -36495,7 +36490,8 @@
   attribute returns an <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code>, which can
   be enumerated to go through each element that adds one or more
   properties to the item. It can also be indexed by name, which will
-  return the property with that name (if there is just one).<p>Each element that adds a property also has a <code title="dom-content"><a href="#dom-content">content</a></code> DOM attribute that returns its
+  return an object with a list of the elements that add properties
+  with that name.<p>Each element that adds a property also has a <code title="dom-content"><a href="#dom-content">content</a></code> DOM attribute that returns its
   value.
 
   <div class="example">
@@ -36505,35 +36501,30 @@
    "net.example.name" property from that item.</p>
 
    <pre>var user = getItems('net.example.user')[0];
-alert('Hello ' + user.properties['net.example.name'].content + '!');</pre>
+alert('Hello ' + user.properties['net.example.name'][0].content + '!');</pre>
 
-  </div><p>When an item has multiple properties with the same name, the
-  <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code> returns a
-  <code><a href="#propertynodelist">PropertyNodeList</a></code> object with all those properties
-  instead of returning just one. The <code><a href="#propertynodelist">PropertyNodeList</a></code>
-  object can be used to obtained all the values at once using
-  <em>its</em> <code title="dom-PropertyNodeList-content"><a href="#dom-propertynodelist-content">content</a></code> attribute, which
+  </div><p>The <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code> object, when indexed by
+  name in this way, actually returns a <code><a href="#propertynodelist">PropertyNodeList</a></code>
+  object with all the matching properties. The
+  <code><a href="#propertynodelist">PropertyNodeList</a></code> object can be used to obtained all the
+  values at once using <em>its</em> <code title="dom-PropertyNodeList-content"><a href="#dom-propertynodelist-content">content</a></code> attribute, which
   returns an array of all the values.<div class="example">
 
    <p>In an earlier example, a "com.example.feline" item had two
-   "com.example.color" values. This script looks up such items and
-   then lists all their values. Because it doesn't know ahead of time
-   if the item has zero, one, or more colors, it checks whether the
-   value returned from the <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code> is a
-   <code><a href="#propertynodelist">PropertyNodeList</a></code> (multiple colors), just a regular
-   element (one color), or null (no colors) before using it.</p>
+   "com.example.color" values. This script looks up the first such
+   item and then lists all its values.</p>
 
    <pre>var cat = getItems('com.example.feline')[0];
-var colors = cat.properties['com.example.color'];
+var colors = cat.properties['com.example.color'].content;
 var result;
-if (!colors) {
+if (colors.length == 0) {
   result = 'Color unknown.';
-} else if (colors instanceof PropertyNodeList) {
-  result = 'Colors:';
-  for (var i = 0; i &lt; colors.content.length; i += 1)
-    result += ' ' + colors.content[i];
+} else if (colors.length == 1) {
+  result = 'Color: ' + colors[0];
 } else {
-  result = 'Color: ' + colors.content;
+  result = 'Colors:';
+  for (var i = 0; i &lt; colors.length; i += 1)
+    result += ' ' + colors[i];
 }</pre>
 
   </div><p>It's also possible to get a list of all the <a href="#property-names">property
@@ -36746,12 +36737,14 @@
    <dd><p>The value is the element's
    <code><a href="#textcontent">textContent</a></code>.</dd>
 
-  </dl><p>If a property's <a href="#concept-property-value" title="concept-property-value">value</a>
+  </dl><p>The <dfn id="url-property-elements">URL property elements</dfn> are the <code><a href="#the-a-element">a</a></code>,
+  <code><a href="#the-area-element">area</a></code>, <code><a href="#audio">audio</a></code>, <code><a href="#the-embed-element">embed</a></code>,
+  <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>, <code><a href="#the-link-element">link</a></code>,
+  <code><a href="#the-object-element">object</a></code>, <code><a href="#the-source-element">source</a></code>, and <code><a href="#video">video</a></code>
+  elements.<p>If a property's <a href="#concept-property-value" title="concept-property-value">value</a>
   is an <a href="#absolute-url">absolute URL</a>, the property must be specified
-  using an <code><a href="#the-a-element">a</a></code>, <code><a href="#the-area-element">area</a></code>, <code><a href="#audio">audio</a></code>,
-  <code><a href="#the-embed-element">embed</a></code>, <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>,
-  <code><a href="#the-link-element">link</a></code>, <code><a href="#the-object-element">object</a></code>, <code><a href="#the-source-element">source</a></code>, or
-  <code><a href="#video">video</a></code> element.<h3 id="microdata-dom-api"><span class="secno">5.3 </span>Microdata DOM API</h3><dl class="domintro"><dt><var title="">document</var> . <code title="dom-items">items</code></dt>
+  using an <a href="#url-property-elements" title="URL property elements">URL property
+  element</a>.<h3 id="microdata-dom-api"><span class="secno">5.3 </span>Microdata DOM API</h3><dl class="domintro"><dt><var title="">document</var> . <code title="dom-items">items</code></dt>
 
    <dd>
 
@@ -36925,28 +36918,7 @@
 
        <li>First Last</li>
 
-      </ul><p>User agents must run the following steps to convert the <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> property's <a href="#concept-property-value" title="concept-property-value">value</a> into an implied
-      <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code>/<code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> pair:</p>
-
-      <ol><li><p>Let <var title="">value</var> be the <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> property's <a href="#concept-property-value" title="concept-property-value">value</a>.</li>
-
-       <li><p><a href="#split-a-string-on-spaces" title="split a string on spaces">Split <var title="">value</var> on spaces</a>, and let <var title="">part one</var> be the first resulting token, and <var title="">part two</var> be the second.</li>
-
-       <li><p>If the last character of <var title="">part one</var> is
-       a U+002C COMMA character (,), then remove that character from
-       <var title="">part one</var> and let the implied <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> be <var title="">part one</var> and the implied <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> be <var title="">part two</var>.</li>
-
-       <li><p>Otherwise, if <var title="">part two</var> is two
-       Unicode code-points long and its second character is a U+002E
-       FULL STOP character (.), then let the implied <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> be <var title="">part one</var> and the implied <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> be the first
-       character of <var title="">part two</var>.</li>
-
-       <li><p>Otherwise, if <var title="">part two</var> is one
-       Unicode code-point long, then let the implied <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> be <var title="">part one</var> and the implied <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> be <var title="">part two</var>.</li>
-
-       <li><p>Otherwise, let the implied <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> be <var title="">part two</var> and the implied <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> be <var title="">part one</var>.</li>
-
-      </ol></dd>
+      </ul></dd>
 
     </dl></dd>
 
@@ -37918,7 +37890,7 @@
   (&lt;span itemprop="organization-unit"&gt;Los Angeles Division&lt;/span&gt;)
  &lt;/p&gt;
  &lt;p&gt;
-  &lt;span class="adr" item&gt;
+  &lt;span itempror="adr" item&gt;
    &lt;span itemprop="street-address"&gt;10201 W. Pico Blvd.&lt;/span&gt;&lt;br&gt;
    &lt;span itemprop="locality"&gt;Los Angeles&lt;/span&gt;,
    &lt;span itemprop="region"&gt;CA&lt;/span&gt;
@@ -37983,7 +37955,7 @@
   vocabulary defined in the iCalendar specification, where more
   information on how to interpret the values can be found. <a href="#references">[RFC2445]</a><p class="note">Only the parts of the iCalendar vocabulary relating
   to events are used here; this vocabulary cannot express a complete
-  iCalendar instance.<dl><dt><dfn id="md-vcevent-attach" title="md-vcevent-attach"><code>attach</code></dfn></dt>
+  iCalendar instance.<dl><dt><dfn id="md-vevent-attach" title="md-vevent-attach"><code>attach</code></dfn></dt>
 
    <dd>
 
@@ -37992,7 +37964,7 @@
     <p>The <a href="#concept-property-value" title="concept-property-value">value</a> must be
     an <a href="#absolute-url">absolute URL</a>.</p>
 
-    <p>Any number of properties with the name <code title="md-vcard-attach">attach</code> may be present within each
+    <p>Any number of properties with the name <code title="md-vevent-attach"><a href="#md-vevent-attach">attach</a></code> may be present within each
     <a href="#concept-item" title="concept-item">item</a> with the type <code title="md-vevent"><a href="#md-vevent">vevent</a></code>.</p>
 
    </dd>
@@ -38544,9 +38516,8 @@
     }
     for (var nameIndex = 0; nameIndex &lt; prop.itemprop.length; nameIndex += 1) {
       var name = prop.itemprop[nameIndex];
-      if (!name.match(':') &amp;&amp; !name.match('.')) {
+      if (!name.match(':') &amp;&amp; !name.match('.'))
         calendar += name.toUpperCase() + parameters + ':' + value + '\r\n';
-      }
     }
   }
   calendar += 'END:VEVENT\r\nEND:VCALENDAR\r\n';
@@ -39293,7 +39264,9 @@
   </div><h4 id="rdf"><span class="secno">5.4.4 </span>RDF</h4><p>The <dfn id="md-about" title="md-about"><code>about</code></dfn> property can
   be used to name an <a href="#concept-item" title="concept-item">item</a> for the
   purposes of refering to the data defined in that item from RDF.<p>A single property with the name <code title="md-about"><a href="#md-about">about</a></code> may be present within each <a href="#concept-item" title="concept-item">item</a>. Its <a href="#concept-property-value" title="concept-property-value">value</a> must be an
-  <a href="#absolute-url">absolute URL</a>.<h3 id="converting-html-to-other-formats"><span class="secno">5.5 </span>Converting HTML to other formats</h3><h4 id="json"><span class="secno">5.5.1 </span>JSON</h4><p>Given a node <var title="">node</var> in a <code>Document</code>,
+  <a href="#absolute-url">absolute URL</a>.<h3 id="converting-html-to-other-formats"><span class="secno">5.5 </span>Converting HTML to other formats</h3><p>In all these algorithms, unless otherwise stated, operations that
+  iterate over a series of elements (whether items, properties, or
+  otherwise) must do so in <a href="#tree-order">tree order</a>.<h4 id="json"><span class="secno">5.5.1 </span>JSON</h4><p>Given a node <var title="">node</var> in a <code>Document</code>,
   a user agent must run the following algorithm to extract that node's
   microdata into a JSON form:<ol><li><p>Let <var title="">result</var> be an empty object.</li>
 
@@ -39497,10 +39470,10 @@
   item</dfn> <var title="">item</var>, it must follow the following
   steps:<ol><li><p>If of the elements whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
    <var title="">item</var>, exactly one has a <a href="#property-names" title="property
-   names">property name</a> equal to the string "<code title="">about</code>", and the <a href="#concept-property-value" title="concept-property-value">property value</a> of that
-   element is an <a href="#absolute-url">absolute URL</a>, let <var title="">subject</var> be that <a href="#absolute-url">absolute
-   URL</a>. Otherwise, let <var title="">subject</var> be a new
-   blank node.</li>
+   names">property name</a> equal to the string "<code title="">about</code>", and that element is a <a href="#url-property-elements" title="URL
+   property elements">URL property element</a>, let <var title="">subject</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of that
+   property. Otherwise, let <var title="">subject</var> be a new blank
+   node.</li>
 
    <li>
 
@@ -39538,14 +39511,10 @@
      reserialise it, check if the <time> was valid, check if it had a
      .date, a .time, a .timezone, etc. -->
 
-     <li><p>Otherwise, if <var title="">element</var> is not an
-     <code><a href="#the-a-element">a</a></code>, <code><a href="#the-area-element">area</a></code>, <code><a href="#audio">audio</a></code>,
-     <code><a href="#the-embed-element">embed</a></code>, <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>,
-     <code><a href="#the-link-element">link</a></code>, <code><a href="#the-object-element">object</a></code>, <code><a href="#the-source-element">source</a></code>, or
-     <code><a href="#video">video</a></code> element, let <var title="">value</var> be a
-     plain literal, with the language information set from the
-     <a href="#language">language</a> of the element, if it is not
-     unknown.</li>
+     <li><p>Otherwise, if <var title="">element</var> is not one of
+     the <a href="#url-property-elements">URL property elements</a>, let <var title="">value</var> be a plain literal, with the language
+     information set from the <a href="#language">language</a> of the element, if
+     it is not unknown.</li>
 
      <li>
 
@@ -39574,7 +39543,506 @@
 
    <li><p>Return <var title="">subject</var>.</li>
 
-  </ol><h4 id="vcard-0"><span class="secno">5.5.3 </span>vCard</h4><p class="XXX">...<h4 id="icalendar"><span class="secno">5.5.4 </span>iCalendar</h4><p class="XXX">...</p><!-- prodid and version are required in output --><!-- value datetime vs date for dtstart, dtend, rdate, exdate; must include new dtstamp --><h4 id="bibtex-0"><span class="secno">5.5.5 </span>BibTeX</h4><p class="XXX">...<h2 id="browsers"><span class="secno">6 </span>Web browsers</h2><div class="impl">
+  </ol><h4 id="vcard-0"><span class="secno">5.5.3 </span>vCard</h4><p>Given a node <var title="">node</var> in a <code>Document</code>,
+  a user agent must run the following algorithm to <dfn id="extracting-a-vcard" title="extracting a vCard">extract any <code title="md-vcard">vcard</code> data represented by that
+  node</dfn>:<ol><li>
+
+    <p>If <var title="">node</var> is not an element that is an <a href="#concept-item" title="concept-item">item</a> with the type <code title="md-vcard"><a href="#md-vcard">vcard</a></code>, then run these substeps:</p>
+
+    <ol><li><p>If <var title="">node</var> has no parent, then there is
+     no vCard. Abort the algorithm, returning nothing.</li>
+
+     <li><p>Let <var title="">node</var> be <var title="">node</var>'s
+     parent.</li>
+
+     <li><p>Restart the entire algorithm with the new value of <var title="">node</var>.</li>
+
+    </ol></li>
+
+   <li><p>Let <var title="">output</var> be an empty string.</li>
+
+   <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">BEGIN</code>" and the value "<code title="">VCARD</code>"
+   to <var title="">output</var>.</li>
+
+   <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">PROFILE</code>" and the value "<code title="">VCARD</code>"
+   to <var title="">output</var>.</li>
+
+   <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">VERSION</code>" and the value "<code title="">3.0</code>"
+   to <var title="">output</var>.</li>
+
+   <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">SOURCE</code>" and <a href="#the-document-s-current-address">the document's current
+   address</a> as the value to <var title="">output</var>.</li>
+
+   <li><p>If <a href="#the-title-element-0">the <code>title</code> element</a> is not null,
+   <a href="#add-a-vcard-line">add a vCard line</a> with the type "<code title="">NAME</code>" and the <code><a href="#textcontent">textContent</a></code> of <a href="#the-title-element-0">the
+   <code>title</code> element</a> as the value to <var title="">output</var>.</li>
+
+   <li>
+
+    <p>For each element <var title="">element</var> that has one or
+    more <a href="#property-names">property names</a> and whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+    <var title="">node</var>: for each name <var title="">name</var>
+    in <var title="">element</var>'s <a href="#property-names">property names</a>, run
+    the following substeps:</p>
+
+    <ol><li><p>If <var title="">name</var> is equal to the string
+     "<code title="">about</code>", skip this name.</li>
+
+     <li><p>Let <var title="">parameters</var> be an empty set of
+     name-value pairs.</li>
+
+     <li>
+
+      <p>Run the appropriate set of substeps from the following
+      list. The steps will set a variable <var title="">value</var>,
+      which is used in the next step.</p>
+
+      <dl><dt>If the property's <a href="#concept-property-value" title="concept-property-value">value</a> is an <a href="#concept-item" title="concept-item">item</a> <var title="">subitem</var>
+       and <var title="">name</var> is <code title="md-vcard-n"><a href="#md-vcard-n">n</a></code></dt>
+
+       <dd>
+
+        <ol><li><p>Let <var title="">n1</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+         property named <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> in <var title="">subitem</var>, or the empty string if there is no
+         such property or the property's value is itself an <a href="#concept-item" title="concept-item">item</a>.</li>
+
+         <li><p>Let <var title="">n2</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+         property named <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> in <var title="">subitem</var>, or the empty string if there is no
+         such property or the property's value is itself an <a href="#concept-item" title="concept-item">item</a>.</li>
+
+         <li><p>Let <var title="">n3</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+         property named <code title="md-vcard-n-additional-name"><a href="#md-vcard-n-additional-name">additional-name</a></code> in
+         <var title="">subitem</var>, or the empty string if there is
+         no such property or the property's value is itself an <a href="#concept-item" title="concept-item">item</a>.</li>
+
+         <li><p>Let <var title="">n4</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+         property named <code title="md-vcard-n-honorific-prefix"><a href="#md-vcard-n-honorific-prefix">honorific-prefix</a></code>
+         in <var title="">subitem</var>, or the empty string if there
+         is no such property or the property's value is itself an
+         <a href="#concept-item" title="concept-item">item</a>.</li>
+
+         <li><p>Let <var title="">n5</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+         property named <code title="md-vcard-n-honorific-suffix"><a href="#md-vcard-n-honorific-suffix">honorific-suffix</a></code>
+         in <var title="">subitem</var>, or the empty string if there
+         is no such property or the property's value is itself an
+         <a href="#concept-item" title="concept-item">item</a>.</li>
+
+         <li>
+
+          <p>Let <var title="">value</var> be the concatenation of the
+          following, in this order:</p>
+
+          <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n1</var></li>
+           <li>A U+003B SEMICOLON character (;)</li>
+           <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n2</var></li>
+           <li>A U+003B SEMICOLON character (;)</li>
+           <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n3</var></li>
+           <li>A U+003B SEMICOLON character (;)</li>
+           <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n4</var></li>
+           <li>A U+003B SEMICOLON character (;)</li>
+           <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n5</var></li>
+          </ol></li>
+
+        </ol></dd>
+
+       <dt>If the property's <a href="#concept-property-value" title="concept-property-value">value</a> is an <a href="#concept-item" title="concept-item">item</a> <var title="">subitem</var>
+       and <var title="">name</var> is <code title="md-vcard-adr"><a href="#md-vcard-adr">adr</a></code></dt>
+
+       <dd>
+
+        <ol><li><p>Let <var title="">value</var> be the empty
+         string.</li>
+
+         <li><p>Append to <var title="">value</var> the result of
+         <a href="#collecting-vcard-subproperties">collecting vCard subproperties</a> named <code title="md-vcard-adr-post-office-box"><a href="#md-vcard-adr-post-office-box">post-office-box</a></code>
+         in <var title="">subitem</var>.</p>
+
+         <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+         <li><p>Append to <var title="">value</var> the result of
+         <a href="#collecting-vcard-subproperties">collecting vCard subproperties</a> named <code title="md-vcard-adr-extended-address"><a href="#md-vcard-adr-extended-address">extended-address</a></code>
+         in <var title="">subitem</var>.</p>
+
+         <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+         <li><p>Append to <var title="">value</var> the result of
+         <a href="#collecting-vcard-subproperties">collecting vCard subproperties</a> named <code title="md-vcard-adr-street-address"><a href="#md-vcard-adr-street-address">street-address</a></code> in
+         <var title="">subitem</var>.</p>
+
+         <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+         <li><p>Append to <var title="">value</var> the result of
+         <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+         <code title="md-vcard-adr-locality"><a href="#md-vcard-adr-locality">locality</a></code> in <var title="">subitem</var>.</p>
+
+         <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+         <li><p>Append to <var title="">value</var> the result of
+         <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+         <code title="md-vcard-adr-region"><a href="#md-vcard-adr-region">region</a></code> in <var title="">subitem</var>.</p>
+
+         <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+         <li><p>Append to <var title="">value</var> the result of
+         <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+         <code title="md-vcard-adr-postal-code"><a href="#md-vcard-adr-postal-code">postal-code</a></code> in
+         <var title="">subitem</var>.</p>
+
+         <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+         <li><p>Append to <var title="">value</var> the result of
+         <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+         <code title="md-vcard-adr-country-name"><a href="#md-vcard-adr-country-name">country-name</a></code>
+         in <var title="">subitem</var>.</p>
+
+         <li><p>If there is a property named <code title="md-vcard-adr-type"><a href="#md-vcard-adr-type">type</a></code> in <var title="">subitem</var>, and the first such property has a
+         <a href="#concept-property-value" title="concept-property-value">value</a> that is not
+         an <a href="#concept-item" title="concept-item">item</a> and whose value
+         consists only of <a href="#alphanumeric-ascii-characters">alphanumeric ASCII characters</a>,
+         then add a parameter named "<code title="">TYPE</code>" whose
+         value is the <a href="#concept-property-value" title="concept-property-value">value</a> of that property
+         to <var title="">parameters</var>.</li>
+
+        </ol></dd>
+
+       <dt>If the property's <a href="#concept-property-value" title="concept-property-value">value</a> is an <a href="#concept-item" title="concept-item">item</a> <var title="">subitem</var>
+       and <var title="">name</var> is <code title="md-vcard-org"><a href="#md-vcard-org">org</a></code></dt>
+
+       <dd>
+
+        <ol><li><p>Let <var title="">value</var> be the empty
+         string.</li>
+
+         <li><p>Append to <var title="">value</var> the result of
+         <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+         <code title="md-vcard-org-organization-name"><a href="#md-vcard-org-organization-name">organization-name</a></code>
+         in <var title="">subitem</var>.</p>
+
+         <li>
+
+          <p>For each property named <code title="md-vcard-org-organization-unit"><a href="#md-vcard-org-organization-unit">organization-unit</a></code>
+          in <var title="">subitem</var>, run the following steps:</p>
+
+          <ol><li><p>If the <a href="#concept-property-value" title="concept-property-value">value</a> of the property
+           is an <a href="#concept-item" title="concept-item">item</a>, then skip
+           this property.</li>
+
+           <li><p>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+           <li><p>Append the result of <a href="#escaping-the-vcard-text-string">escaping the vCard text
+           string</a> given by the <a href="#concept-property-value" title="concept-property-value">value</a> of the property
+           to <var title="">value</var>.</li>
+
+          </ol></li>
+
+        </ol></dd>
+
+       <dt>If the property's <a href="#concept-property-value" title="concept-property-value">value</a> is an <a href="#concept-item" title="concept-item">item</a> <var title="">subitem</var>
+       with the type <code title="md-vcard"><a href="#md-vcard">vcard</a></code> and <var title="">name</var> is <code title="md-vcard-agent"><a href="#md-vcard-agent">agent</a></code></dt>
+
+       <dd>
+
+        <ol><li><p>Let <var title="">value</var> be the result of
+         <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> obtained from
+         <a href="#extracting-a-vcard">extracting a vCard</a> from the element that
+         represents <var title="">subitem</var>.</li>
+
+         <li><p>Add a parameter named "<code title="">VALUE</code>"
+         whose value is "<code title="">VCARD</code>" to <var title="">parameters</var>.</li>
+
+        </ol></dd>
+
+       <dt>If the property's <a href="#concept-property-value" title="concept-property-value">value</a> is an <a href="#concept-item" title="concept-item">item</a> and <var title="">name</var>
+       is none of the above</dt>
+
+       <dd>
+
+        <ol><li><p>Let <var title="">value</var> the result of
+         <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+         <code title="">value</code> in <var title="">subitem</var>.</p>
+
+         <li><p>If there is a property named <code title="">type</code> in <var title="">subitem</var>, and the
+         first such property has a <a href="#concept-property-value" title="concept-property-value">value</a> that is not an
+         <a href="#concept-item" title="concept-item">item</a> and whose value
+         consists only of <a href="#alphanumeric-ascii-characters">alphanumeric ASCII characters</a>,
+         then add a parameter named "<code title="">TYPE</code>" whose
+         value is the <a href="#concept-property-value" title="concept-property-value">value</a> of that property
+         to <var title="">parameters</var>.</li>
+
+        </ol></dd>
+
+       <dt>Otherwise (the property's <a href="#concept-property-value" title="concept-property-value">value</a> is not an <a href="#concept-item" title="concept-item">item</a>)</dt>
+
+       <dd>
+
+        <ol><li><p>Let <var title="">value</var> be the property's <a href="#concept-property-value" title="concept-property-value">value</a>.</li>
+
+         <li><p>If <var title="">element</var> is one of the <a href="#url-property-elements">URL
+         property elements</a>, add a parameter with the name "<code title="">VALUE</code>" and the value "<code title="">URI</code>" to <var title="">parameters</var>.</li>
+
+         <li><p>Otherwise, if <var title="">element</var> is a
+         <code><a href="#the-time-element">time</a></code> element and the <var title="">value</var> is
+         a <a href="#valid-date-string">valid date string</a>, add a parameter with the name
+         "<code title="">VALUE</code>" and the value "<code title="">DATE</code>" to <var title="">parameters</var>.</li>
+
+         <li><p>Otherwise, if <var title="">element</var> is a
+         <code><a href="#the-time-element">time</a></code> element and the <var title="">value</var> is
+         a <a href="#valid-global-date-and-time-string">valid global date and time string</a>, add a
+         parameter with the name "<code title="">VALUE</code>" and the
+         value "<code title="">DATE-TIME</code>" to <var title="">parameters</var>.</li>
+
+         <li><p>Prefix every U+005C REVERSE SOLIDUS character (\) in
+         <var title="">value</var> with another U+005C REVERSE SOLIDUS
+         character (\).</li>
+
+         <li><p>Prefix every U+002C COMMA character (,) in <var title="">value</var> with a U+005C REVERSE SOLIDUS character
+         (\).</li>
+
+         <li><p>Unless <var title="">name</var> is <code title="md-vcard-geo"><a href="#md-vcard-geo">geo</a></code>, prefix every U+003B SEMICOLON
+         character (;) in <var title="">value</var> with a U+005C
+         REVERSE SOLIDUS character (\).</li>
+
+         <li><p>Replace every U+000D CARRIAGE RETURN U+000A LINE FEED
+         character pair (CRLF) in <var title="">value</var> with a U+005C REVERSE
+         SOLIDUS character (\) followed by a U+006E LATIN SMALL LETTER
+         N.</li>
+
+         <li><p>Replace every remaining U+000D CARRIAGE RETURN (CR) or
+         U+000A LINE FEED (LF) character in <var title="">value</var>
+         with a U+005C REVERSE SOLIDUS character (\) followed by a U+006E
+         LATIN SMALL LETTER N.</li>
+
+        </ol></dd>
+
+      </dl></li>
+
+     <li>
+
+      <p><a href="#add-a-vcard-line">Add a vCard line</a> with the type <var title="">name</var>, the parameters <var title="">parameters</var>, and the value <var title="">value</var> to <var title="">output</var>.</p>
+
+     </li>
+
+    </ol></li>
+
+   <li>
+
+    <p>If there is no property named <code title="md-vcard-n"><a href="#md-vcard-n">n</a></code>
+    whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding
+    item</a> is <var title="">node</var>, then run the following
+    substeps:</p>
+
+    <ol><li><p>If there is no property named <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+     <var title="">node</var>, then skip the remainder of these
+     substeps.</li>
+
+     <li><p>If the first property named <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+     <var title="">node</var> has a <a href="#concept-property-value" title="concept-property-value">value</a> that is an <a href="#concept-item" title="concept-item">item</a>, then skip the remainder of
+     these substeps.</li>
+
+     <li><p>Let <var title="">fn</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first property
+     named <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+     <var title="">node</var>.</li>
+
+     <li><p>If there is a property named <code title="md-vcard-org"><a href="#md-vcard-org">org</a></code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+     <var title="">node</var>, and the <a href="#concept-property-value" title="concept-property-value">value</a> of the first such
+     property is equal to <var title="">fn</var> (and is not an <a href="#concept-item" title="concept-item">item</a>), then <a href="#add-a-vcard-line">add a vCard
+     line</a> with the type "<code title="">N</code>" whose value
+     is four U+003B SEMICOLON characters ("<code title="">;;;;</code>") to <var title="">output</var>. Then, skip
+     the remainder of these substeps.</li>
+
+     <li><p>If the <a href="#space-character" title="space character">space
+     characters</a> in <var title="">fn</var>, if any, are not all
+     contiguous, then skip the remainder of these substeps.</li>
+
+     <li><p><a href="#split-a-string-on-spaces" title="split a string on spaces">Split <var title="">fn</var> on spaces</a>, and let <var title="">part
+     one</var> be the first resulting token, and <var title="">part
+     two</var> be the second, if any, or the empty string if there is
+     no second token. (There cannot be three, given the previous
+     step.)</li>
+
+     <li>
+
+      <p>If the last character of <var title="">part one</var> is a
+      U+002C COMMA character (,), then remove that character from <var title="">part one</var> and <a href="#add-a-vcard-line">add a vCard line</a> with
+      the type "<code title="">N</code>" whose value is the
+      concatenation of the following strings:</p>
+
+      <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part one</var></li>
+       <li>A U+003B SEMICOLON character (;)</li>
+       <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part two</var></li>
+       <li>Three U+003B SEMICOLON characters (;)</li>
+      </ol><p>Then, skip the remainder of these substeps.</p>
+
+     </li>
+
+     <li>
+
+      <p>If <var title="">part two</var> is two Unicode code-points
+      long and its second character is a U+002E FULL STOP character
+      (.), then <a href="#add-a-vcard-line">add a vCard line</a> with the type "<code title="">N</code>" whose value is the concatenation of the
+      following strings:</p>
+
+      <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part one</var></li>
+       <li>A U+003B SEMICOLON character (;)</li>
+       <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> consisting of the first character of <var title="">part two</var></li>
+       <li>Three U+003B SEMICOLON characters (;)</li>
+      </ol><p>Then, skip the remainder of these substeps.</p>
+
+     </li>
+
+     <li>
+
+      <p>If <var title="">part two</var> is one Unicode code-point
+      long, then <a href="#add-a-vcard-line">add a vCard line</a> with the type "<code title="">N</code>" whose value is the concatenation of the
+      following strings:</p>
+
+      <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part one</var></li>
+       <li>A U+003B SEMICOLON character (;)</li>
+       <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part two</var></li>
+       <li>Three U+003B SEMICOLON characters (;)</li>
+      </ol><p>Then, skip the remainder of these substeps.</p>
+
+     </li>
+
+     <li>
+
+      <p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">N</code>" whose value is the concatenation of the
+      following strings:</p>
+
+      <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part two</var></li>
+       <li>A U+003B SEMICOLON character (;)</li>
+       <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part one</var></li>
+       <li>Three U+003B SEMICOLON characters (;)</li>
+      </ol></li>
+
+    </ol></li>
+
+   <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">END</code>" and the value "<code title="">VCARD</code>"
+   to <var title="">output</var>.</li>
+
+  </ol><p>When the above algorithm says that the user agent is to <dfn id="add-a-vcard-line">add
+  a vCard line</dfn> consisting of a type <var title="">type</var>,
+  optionally some parameters, and a value <var title="">value</var> to
+  a string <var title="">output</var>, it must run the following
+  steps:<ol><li><p>Let <var title="">line</var> be an empty string.
+
+   <li><p>Append <var title="">type</var>, <a href="#converted-to-uppercase">converted to
+   uppercase</a>, to <var title="">line</var>.</li>
+
+   <li>
+
+    <p>If there are any parameters, then for each parameter, in the
+    order that they were added, run these substeps:</p>
+
+    <ol><li><p>Append a U+003B SEMICOLON character (;) to <var title="">line</var>.</li>
+
+     <li><p>Append the parameter's name to <var title="">line</var>.</li>
+
+     <li><p>Append a U+003D EQUALS SIGN character (=) to <var title="">line</var>.</li>
+
+     <li><p>Append the parameter's value to <var title="">line</var>.</li>
+
+    </ol></li>
+
+   <li><p>Append a U+003A COLON character (:) to <var title="">line</var>.</li>
+
+   <li><p>Append <var title="">value</var> to <var title="">line</var>.</li>
+
+   <li><p>Let <var title="">maximum length</var> be 75.</li>
+
+   <li>
+
+    <p>If and while <var title="">line</var> is longer than <var title="">maximum length</var> Unicode code points long, run the
+    following substeps:</p>
+
+    <ol><li><p>Append the first <var title="">maximum length</var>
+     Unicode code points of <var title="">line</var> to <var title="">output</var>.</li>
+
+     <li><p>Remove the first <var title="">maximum length</var>
+     Unicode code points from <var title="">line</var>.</li>
+
+     <li><p>Append a U+000D CARRIAGE RETURN character (CR) to <var title="">output</var>.</li>
+
+     <li><p>Append a U+000A LINE FEED character (LF) to <var title="">output</var>.</li>
+
+     <li><p>Append a U+0020 SPACE character to <var title="">output</var>.</li>
+
+     <li><p>Let <var title="">maximum length</var> be 74.</li>
+
+    </ol></li>
+
+   <li><p>Append (what remains of) <var title="">line</var> to <var title="">output</var>.</li>
+
+   <li><p>Append a U+000D CARRIAGE RETURN character (CR) to <var title="">output</var>.</li>
+
+   <li><p>Append a U+000A LINE FEED character (LF) to <var title="">output</var>.</li>
+
+  </ol><p>When the steps above require the user agent to obtain the result
+  of <dfn id="collecting-vcard-subproperties">collecting vCard subproperties</dfn> named <var title="">subname</var> in <var title="">subitem</var>, the user
+  agent must run the following steps:<ol><li><p>Let <var title="">value</var> be the empty string.</li>
+
+   <li>
+
+    <p>For each property named <var title="">subname</var> in the item
+    <var title="">subitem</var>, run the following substeps:</p>
+
+    <ol><li><p>If the <a href="#concept-property-value" title="concept-property-value">value</a>
+     of the property is itself an <a href="#concept-item" title="concept-item">item</a>, then skip this
+     property.</li>
+
+     <li><p>If this is not the first property named <var title="">subname</var> in <var title="">subitem</var> (ignoring
+     any that were skipped by the previous step), then append a U+002C
+     COMMA character (,) to <var title="">value</var>.</li>
+
+     <li><p>Append the result of <a href="#escaping-the-vcard-text-string">escaping the vCard text
+     string</a> given by the <a href="#concept-property-value" title="concept-property-value">value</a> of the property to
+     <var title="">value</var>.</li>
+
+    </ol></li>
+
+   <li><p>Return <var title="">value</var>.</li>
+
+  </ol><p>When the steps above require the user agent to obtain the result
+  of <dfn id="collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</dfn> named <var title="">subname</var> in <var title="">subitem</var>, the user
+  agent must run the following steps:<ol><li><p>If there are no properties named <var title="">subname</var>
+   in <var title="">subitem</var>, then abort these substeps,
+   returning the empty string.</li>
+
+   <li><p>If the <a href="#concept-property-value" title="concept-property-value">value</a> of
+   the first property named <var title="">subname</var> in <var title="">subitem</var> is an <a href="#concept-item" title="concept-item">item</a>, then abort these substeps,
+   returning the empty string.</li>
+
+   <li><p>Return the result of <a href="#escaping-the-vcard-text-string">escaping the vCard text
+   string</a> given by the <a href="#concept-property-value" title="concept-property-value">value</a> of the first property
+   named <var title="">subname</var> in <var title="">subitem</var>.</li>
+
+  </ol><p>When the above algorithms say the user agent is to <dfn id="escaping-the-vcard-text-string" title="escaping the vCard text string">escape the vCard text
+  string</dfn> <var title="">value</var>, the user agent must use the
+  following steps:<ol><li><p>Prefix every U+005C REVERSE SOLIDUS character (\) in <var title="">value</var> with another U+005C REVERSE SOLIDUS character
+   (\).</li>
+
+   <li><p>Prefix every U+002C COMMA character (,) in <var title="">value</var> with a U+005C REVERSE SOLIDUS character
+   (\).</li>
+
+   <li><p>Prefix every U+003B SEMICOLON character (;) in <var title="">value</var> with a U+005C REVERSE SOLIDUS character
+   (\).</li>
+
+   <li><p>Replace every U+000D CARRIAGE RETURN U+000A LINE FEED
+   character pair (CRLF) in <var title="">value</var> with a U+005C
+   REVERSE SOLIDUS character (\) followed by a U+006E LATIN SMALL
+   LETTER N.</li>
+
+   <li><p>Replace every remaining U+000D CARRIAGE RETURN (CR) or
+   U+000A LINE FEED (LF) character in <var title="">value</var> with a
+   U+005C REVERSE SOLIDUS character (\) followed by a U+006E LATIN
+   SMALL LETTER N.</li>
+
+   <li><p>Return the mutated <var title="">value</var>.</li>
+
+  </ol><p class="note">This algorithm can generate invalid vCard output, if
+  the input does not conform to the rules described for the <code title="md-vcard"><a href="#md-vcard">vcard</a></code> <a href="#predefined-type">predefined type</a> and <a href="#predefined-property-name" title="predefined property name">predefined property
+  names</a>.</p><!-- of course since vcard doesn't define error
+  handling, this is somewhat problematic. --><h4 id="icalendar"><span class="secno">5.5.4 </span>iCalendar</h4><p class="XXX">...</p><!-- prodid and version are required in output --><!-- value datetime vs date for dtstart, dtend, rdate, exdate; must include new dtstamp --><h4 id="bibtex-0"><span class="secno">5.5.5 </span>BibTeX</h4><p class="XXX">...<h2 id="browsers"><span class="secno">6 </span>Web browsers</h2><div class="impl">
 
   <p>This section describes features that apply most directly to Web
   browsers. Having said that, unless specified elsewhere, the
Received on Monday, 18 May 2009 10:28:25 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:14:05 GMT