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

html5/spec Overview.html,1.2227,1.2228

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 06 May 2009 23:07:33 +0000
To: public-html-commits@w3.org
Message-Id: <E1M1qD7-0007CS-Os@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27662

Modified Files:
	Overview.html 
Log Message:
Add cite='' attribute to <section> and <article>. (whatwg r3069)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2227
retrieving revision 1.2228
diff -u -d -r1.2227 -r1.2228
--- Overview.html	4 May 2009 06:10:36 -0000	1.2227
+++ Overview.html	6 May 2009 23:07:30 -0000	1.2228
@@ -148,7 +148,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 4 May 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 6 May 2009</h2>
    <!--:ZZZ-->
    <dl><!-- ZZZ: update the month/day (twice), (un)comment out
     <dt>This Version:</dt>
@@ -241,7 +241,7 @@
   track.
   <!--ZZZ:-->
   <!--This specification is the 23 April 2009 Working Draft.-->
-  This specification is the 4 May 2009 Editor's Draft.
+  This specification is the 6 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)
@@ -4237,8 +4237,10 @@
 
    </dd>
 
-   <dt>If the element is a <code><a href="#the-blockquote-element">blockquote</a></code>, <code><a href="#the-q-element">q</a></code>,
-   <code><a href="#the-ins-element">ins</a></code>, or <code><a href="#the-del-element">del</a></code> element with a <code title="">cite</code> attribute</dt>
+   <dt>If the element is a <code><a href="#the-q-element">q</a></code>, <code><a href="#the-blockquote-element">blockquote</a></code>,
+   <code><a href="#the-section-element">section</a></code>, <code><a href="#the-article-element">article</a></code>, <code><a href="#the-ins-element">ins</a></code>, or
+   <code><a href="#the-del-element">del</a></code> element with a <code title="">cite</code>
+   attribute</dt>
 
    <dd>
 
@@ -10769,15 +10771,33 @@
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dt>Content attributes:</dt>
    <dd><a href="#global-attributes">Global attributes</a></dd>
+   <dd><code title="attr-section-cite"><a href="#attr-section-cite">cite</a></code></dd>
    <dt>DOM interface:</dt>
-   <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
+   <dd>
+<pre class="idl">interface <dfn id="htmlsectionelement">HTMLSectionElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+           attribute DOMString <a href="#dom-section-cite" title="dom-section-cite">cite</a>;
+};</pre>
+   </dd>
   </dl><p>The <code><a href="#the-section-element">section</a></code> element <a href="#represents">represents</a> a
   generic document or application section. A section, in this context,
   is a thematic grouping of content, typically with a heading, possibly
   with a footer.<p class="example">Examples of sections would be chapters, the
   various tabbed pages in a tabbed dialog box, or the numbered
   sections of a thesis. A Web site's home page could be split into
-  sections for an introduction, news items, contact information.<div class="example">
+  sections for an introduction, news items, contact information.<p>The <dfn id="attr-section-cite" title="attr-section-cite"><code>cite</code></dfn>
+  attribute may be used if the content of the section was taken from
+  another page (e.g. syndicating content from multiple sources on one
+  page). The attribute, if present, must contain a <a href="#valid-url">valid
+  URL</a> referencing the original source. <span class="impl">To
+  obtain the corresponding citation link, the value of the attribute
+  must be <a href="#resolve-a-url" title="resolve a url">resolved</a> relative to the
+  element. User agents should allow users to follow such citation
+  links.</span><div class="impl">
+
+  <p>The <dfn id="dom-section-cite" title="dom-section-cite"><code>cite</code></dfn> DOM
+  attribute must <a href="#reflect">reflect</a> the element's <code title="attr-section-cite"><a href="#attr-section-cite">cite</a></code> content attribute.</p>
+
+  </div><div class="example">
 
    <p>In the following example, we see an article (part of a larger
    Web page) about apples, containing two short sections.</p>
@@ -10865,11 +10885,14 @@
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dt>Content attributes:</dt>
    <dd><a href="#global-attributes">Global attributes</a></dd>
-<!--
-XXX attributes to give the date authored, date published
--->
+   <dd><code title="attr-article-cite"><a href="#attr-article-cite">cite</a></code></dd>
+   <!-- v2 attributes to give the date authored, date published, name of author, etc -->
    <dt>DOM interface:</dt>
-   <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
+   <dd>
+<pre class="idl">interface <dfn id="htmlarticleelement">HTMLArticleElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+           attribute DOMString <a href="#dom-article-cite" title="dom-article-cite">cite</a>;
+};</pre>
+   </dd>
   </dl><p>The <code><a href="#the-article-element">article</a></code> element <a href="#represents">represents</a> a
   section of a page that consists of a composition that forms an
   independent part of a document, page, or site. This could be a forum
@@ -10879,9 +10902,7 @@
   that its contents could stand alone, for example in syndication.
   However, the element is still associated with its ancestors; for
   instance, contact information that <a href="#applyToSection">applies</a> to a parent <code><a href="#the-body-element">body</a></code>
-  element still covers the <code><a href="#the-article-element">article</a></code> as well.</p><!-- XXX
-  or should we apply the rules in the last paragraph to all articles?
-  --><p>When <code><a href="#the-article-element">article</a></code> elements are nested, the inner
+  element still covers the <code><a href="#the-article-element">article</a></code> as well.<p>When <code><a href="#the-article-element">article</a></code> elements are nested, the inner
   <code><a href="#the-article-element">article</a></code> elements represent articles that are in
   principle related to the contents of the outer article. For
   instance, a Web log entry on a site that accepts user-submitted
@@ -10889,7 +10910,20 @@
   elements nested within the <code><a href="#the-article-element">article</a></code> element for the Web
   log entry.<p>Author information associated with an <code><a href="#the-article-element">article</a></code>
   element (q.v. the <code><a href="#the-address-element">address</a></code> element) does not apply to
-  nested <code><a href="#the-article-element">article</a></code> elements.<h4 id="the-aside-element"><span class="secno">4.4.5 </span>The <dfn><code>aside</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+  nested <code><a href="#the-article-element">article</a></code> elements.<p>The <dfn id="attr-article-cite" title="attr-article-cite"><code>cite</code></dfn>
+  attribute may be used if the content of the article was taken from
+  another page (e.g. syndicating content from multiple sources on one
+  page). The attribute, if present, must contain a <a href="#valid-url">valid
+  URL</a> referencing the original source. <span class="impl">To
+  obtain the corresponding citation link, the value of the attribute
+  must be <a href="#resolve-a-url" title="resolve a url">resolved</a> relative to the
+  element. User agents should allow users to follow such citation
+  links.</span><div class="impl">
+
+  <p>The <dfn id="dom-article-cite" title="dom-article-cite"><code>cite</code></dfn> DOM
+  attribute must <a href="#reflect">reflect</a> the element's <code title="attr-article-cite"><a href="#attr-article-cite">cite</a></code> content attribute.</p>
+
+  </div><h4 id="the-aside-element"><span class="secno">4.4.5 </span>The <dfn><code>aside</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#sectioning-content-0">Sectioning content</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
@@ -14483,16 +14517,12 @@
   change. When that document is long, for instance the minutes of a
   meeting, authors are encouraged to include a fragment identifier
   pointing to the specific part of that document that discusses the
-  change.<div class="impl">
-
-  <p>If the <code title="attr-mod-cite"><a href="#attr-mod-cite">cite</a></code> attribute is
+  change.<p>If the <code title="attr-mod-cite"><a href="#attr-mod-cite">cite</a></code> attribute is
   present, it must be a <a href="#valid-url">valid URL</a> that explains the
-  change. To obtain the corresponding citation link, the value of the
-  attribute must be <a href="#resolve-a-url" title="resolve a url">resolved</a>
-  relative to the element. User agents should allow users to follow
-  such citation links.</p>
-
-  </div><p>The <dfn id="attr-mod-datetime" title="attr-mod-datetime"><code>datetime</code></dfn>
+  change. <span class="impl">To obtain the corresponding citation
+  link, the value of the attribute must be <a href="#resolve-a-url" title="resolve a
+  url">resolved</a> relative to the element. User agents should
+  allow users to follow such citation links.</span><p>The <dfn id="attr-mod-datetime" title="attr-mod-datetime"><code>datetime</code></dfn>
   attribute may be used to specify the time and date of the change.<p>If present, the <code title="attr-mod-datetime"><a href="#attr-mod-datetime">datetime</a></code>
   attribute must be a <a href="#valid-global-date-and-time-string">valid global date and time string</a>
   value.<div class="impl">
@@ -58596,8 +58626,8 @@
   <p>User agents are expected to allow users to <a href="#navigate">navigate</a>
   <a href="#browsing-context" title="browsing context">browsing contexts</a> to the
   resources <a href="#resolve-a-url" title="resolve a url">indicated</a> by the <code title="">cite</code> attributes on <code><a href="#the-q-element">q</a></code>,
-  <code><a href="#the-blockquote-element">blockquote</a></code>, <code><a href="#the-ins-element">ins</a></code>, and <code><a href="#the-del-element">del</a></code>
-  elements.</p>
+  <code><a href="#the-blockquote-element">blockquote</a></code>, <code><a href="#the-section-element">section</a></code>, <code><a href="#the-article-element">article</a></code>,
+  <code><a href="#the-ins-element">ins</a></code>, and <code><a href="#the-del-element">del</a></code> elements.</p>
 
   <p>User agents are expected to surface <a href="#hyperlink" title="hyperlink">hyperlinks</a> created by <code><a href="#the-link-element">link</a></code>
   elements in their user interface.</p>
Received on Wednesday, 6 May 2009 23:07:42 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 6 May 2009 23:07:44 GMT