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

html5/spec Overview.html,1.2269,1.2270

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 18 May 2009 06:18:52 +0000
To: public-html-commits@w3.org
Message-Id: <E1M5wBZ-0002jY-1F@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv10494

Modified Files:
	Overview.html 
Log Message:
Not particularly great bibtex serialisation. If anyone knows of improvements that could be made here, please let me know. (whatwg r3112)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2269
retrieving revision 1.2270
diff -u -d -r1.2269 -r1.2270
--- Overview.html	16 May 2009 11:26:53 -0000	1.2269
+++ Overview.html	18 May 2009 06:18:49 -0000	1.2270
@@ -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 16 May 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 18 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 16 May 2009 Editor's Draft.
+  This specification is the 18 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)
@@ -38651,24 +38651,33 @@
 
    <dd>
 
-    <p>Gives the name of an author of the work cited by the
+    <p>Gives the name of the authors of the work cited by the
     bibliographic entry.</p>
 
     <p>The <a href="#concept-property-value" title="concept-property-value">value</a> must be
     text.</p>
 
-    <p>Any number of properties with the name <code title="md-bibtex-author"><a href="#md-bibtex-author">author</a></code> may be present within each
+    <!-- which should be a list of names, separated by "and", with the
+    weird BibTeX names form:
+      First last-prefix Last
+      last-prefix Last, First
+      last-prefix Last, last-suffix, First
+      http://artis.inrialpes.fr/~Xavier.Decoret/resources/xdkbibtex/bibtex_summary.html#names
+    ...and with "others" as the last name if there's more than listed. -->
+
+    <p>A single property with the name <code title="md-bibtex-author"><a href="#md-bibtex-author">author</a></code> may be present within each
     <a href="#concept-item" title="concept-item">item</a> with the type <code title="md-bibtex"><a href="#md-bibtex">bibtex</a></code>. When such an <a href="#concept-item" title="concept-item">item</a> has an <code title="md-bibtex-entrytype"><a href="#md-bibtex-entrytype">entrytype</a></code> property whose value
     is one of <code title="md-bibtex-entrytype-article"><a href="#md-bibtex-entrytype-article">article</a></code>, <code title="md-bibtex-entrytype-incollection"><a href="#md-bibtex-entrytype-incollection">incollection</a></code>,
     <code title="md-bibtex-entrytype-inproceedings"><a href="#md-bibtex-entrytype-inproceedings">inproceedings</a></code>,
     <code title="md-bibtex-entrytype-mastersthesis"><a href="#md-bibtex-entrytype-mastersthesis">mastersthesis</a></code>,
     <code title="md-bibtex-entrytype-phdthesis"><a href="#md-bibtex-entrytype-phdthesis">phdthesis</a></code>,
-    <code title="md-bibtex-entrytype-techreport"><a href="#md-bibtex-entrytype-techreport">techreport</a></code>,
-    or <code title="md-bibtex-entrytype-unpublished"><a href="#md-bibtex-entrytype-unpublished">unpublished</a></code>, or
-    when such an <a href="#concept-item" title="concept-item">item</a> has an <code title="md-bibtex-entrytype"><a href="#md-bibtex-entrytype">entrytype</a></code> property whose value
-    is one of <code title="md-bibtex-entrytype-book"><a href="#md-bibtex-entrytype-book">book</a></code> or
-    <code title="md-bibtex-entrytype-inbook"><a href="#md-bibtex-entrytype-inbook">inbook</a></code> and has no
-    property with the name <code title="md-bibtex-editor"><a href="#md-bibtex-editor">editor</a></code>, at least one property with
+    <code title="md-bibtex-entrytype-techreport"><a href="#md-bibtex-entrytype-techreport">techreport</a></code>, or
+    <code title="md-bibtex-entrytype-unpublished"><a href="#md-bibtex-entrytype-unpublished">unpublished</a></code>,
+    or when such an <a href="#concept-item" title="concept-item">item</a> has an
+    <code title="md-bibtex-entrytype"><a href="#md-bibtex-entrytype">entrytype</a></code> property whose
+    value is one of <code title="md-bibtex-entrytype-book"><a href="#md-bibtex-entrytype-book">book</a></code>
+    or <code title="md-bibtex-entrytype-inbook"><a href="#md-bibtex-entrytype-inbook">inbook</a></code> and has
+    no property with the name <code title="md-bibtex-editor"><a href="#md-bibtex-editor">editor</a></code>, at least one property with
     the name <code title="md-bibtex-author"><a href="#md-bibtex-author">author</a></code> must be
     present within the <a href="#concept-item" title="concept-item">item</a>.</p>
 
@@ -38738,13 +38747,15 @@
 
    <dd>
 
-    <p>Gives the name of an editor of the work cited by the
+    <p>Gives the name of the editors of the work cited by the
     bibliographic entry.</p>
 
     <p>The <a href="#concept-property-value" title="concept-property-value">value</a> must be
     text.</p>
 
-    <p>Any number of properties with the name <code title="md-bibtex-editor"><a href="#md-bibtex-editor">editor</a></code> may be present within each
+    <!-- see note at "author" -->
+
+    <p>A single property with the name <code title="md-bibtex-editor"><a href="#md-bibtex-editor">editor</a></code> may be present within each
     <a href="#concept-item" title="concept-item">item</a> with the type <code title="md-bibtex"><a href="#md-bibtex">bibtex</a></code>. When such an <a href="#concept-item" title="concept-item">item</a> has an <code title="md-bibtex-entrytype"><a href="#md-bibtex-entrytype">entrytype</a></code> property whose value
     is one of <code title="md-bibtex-entrytype-book"><a href="#md-bibtex-entrytype-book">book</a></code> or
     <code title="md-bibtex-entrytype-inbook"><a href="#md-bibtex-entrytype-inbook">inbook</a></code> and has no
@@ -40264,7 +40275,91 @@
   <code title="md-vevent"><a href="#md-vevent">vevent</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 icalendar doesn't define
-  error handling, this is somewhat problematic. --><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">
+  error handling, this is somewhat problematic. --><h4 id="bibtex-0"><span class="secno">5.5.5 </span>BibTeX</h4><p>Given a node <var title="">node</var> in a <code>Document</code>,
+  a user agent must run the following algorithm to extract any <code title="md-bibtex"><a href="#md-bibtex">bibtex</a></code> data represented by that node into a
+  form that vaguely resembles the format used by BibTeX
+  processors:<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-bibtex"><a href="#md-bibtex">bibtex</a></code>, then run these substeps:</p>
+
+    <ol><li><p>If <var title="">node</var> has no parent, then there is
+     no event to output. 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>Append a U+0040 COMMERCIAL AT character (@) to <var title="">output</var>.</li>
+
+   <li><p>Append the <a href="#concept-property-value" title="concept-property-value">value</a>
+   of the first property named <code title="mb-bibtex-entrytype">entrytype</code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+   <var title="">node</var> if that <a href="#concept-property-value" title="concept-property-value">value</a> is not itself an <a href="#concept-item" title="concept-item">item</a>.</li>
+
+   <li><p>Append a U+007B LEFT CURLY BRACKET character ({) to <var title="">output</var>.</li>
+
+   <li><p>Append the <a href="#concept-property-value" title="concept-property-value">value</a>
+   of the first property named <code title="mb-bibtex-bibtex-id">bibtex-id</code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+   <var title="">node</var> if that <a href="#concept-property-value" title="concept-property-value">value</a> is not itself an <a href="#concept-item" title="concept-item">item</a>.</li>
+
+   <li><p>Append a U+002C COMMA character (,) and a U+000A LINE FEED
+   (LF) character 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 appropriate set of substeps from the following list:</p>
+
+    <ol><li><p>If <var title="">name</var> is equal to the string "<code title="md-about"><a href="#md-about">about</a></code>", "<code title="md-bibtex-entrytype"><a href="#md-bibtex-entrytype">entrytype</a></code>", or "<code title="md-bibtex-bibtex-id"><a href="#md-bibtex-bibtex-id">bibtex-id</a></code>", skip this
+     name.</li>
+
+     <li><p>If <var title="">name</var> contains either a U+003A COLON
+     character (:) or a U+002E FULL STOP character (.), skip this
+     name.</li>
+
+     <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>Append two U+0020 SPACE characters to <var title="">output</var>.</li>
+
+     <li><p>Append <var title="">name</var></p> to var
+     title=""&gt;output.</li>
+
+     <li><p>Append a U+0020 SPACE character, a U+003D EQUALS SIGN
+     character (=), and another U+0020 SPACE character to <var title="">output</var>.</li>
+
+     <li><p>Let <var title="">value</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the
+     property.</li>
+
+     <li><p>Replace all occurrences of the U+0022 QUOTATION MARK
+     character (") in <var title="">value</var> with the
+     three-character sequence "<code title="">{"}</code>" (U+007B LEFT
+     CURLY BRACKET, U+0022 QUOTATION MARK, U+007D RIGHT CURLY
+     BRACKET).</li>
+
+     <li><p>Append a U+0022 QUOTATION MARK character (") to <var title="">output</var>.</li>
+
+     <li><p>Append <var title="">value</var> to <var title="">output</var>.</li>
+
+     <li><p>Append a U+0022 QUOTATION MARK character (") to <var title="">output</var>.</li>
+
+     <li><p>Append a U+002C COMMA character (,) and a U+000A LINE FEED
+     (LF) character to <var title="">output</var>.</li>
+
+    </ol></li>
+
+   <li><p>Append aU+007D RIGHT CURLY BRACKET character (}) to <var title="">output</var>.</li>
+
+  </ol><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 06:19:01 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 18 May 2009 06:19:03 GMT