Aligned the editors draft to the /TR version
authorPhilippe Le Hegaret <plh@w3.org>
Thu, 26 Feb 2015 12:02:49 -0500
changeset 111 1ee42b32a877
parent 110 217e6b995ac9
child 112 6a275c5a86bc
Aligned the editors draft to the /TR version
longdesc1/longdesc.html
--- a/longdesc1/longdesc.html	Fri Jun 20 17:12:43 2014 -0400
+++ b/longdesc1/longdesc.html	Thu Feb 26 12:02:49 2015 -0500
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html dir="ltr" lang="en">
   <head>
-    <meta content="text/html; charset=UTF-8" http-equiv="content-type">
+    <meta charset="UTF-8">
     <title>HTML5 Image Description Extension (longdesc)</title>
     <style type="text/css">
       .issue {border: dashed red 2px; background-color: #ffd}
@@ -337,53 +337,7 @@
     </section>
     <section class="introductory" id="sotd">
       <h2>Status of This Document</h2>
-      <p> <em>This section describes the status of this document at the time of
-          its publication. Other documents may supersede this document. A list
-          of current <abbr title="World Wide Web Consortium">W3C</abbr>
-          publications and the latest revision of this technical report can be
-          found in the <a href="http://www.w3.org/TR/"><abbr title="World Wide Web Consortium">W3C</abbr>
-            technical reports index</a> at http://www.w3.org/TR/.</em> </p>
-      <p> This document is proposed to the
-        HTML Accessibility Task Force for publication as a Candidate Recommendation.
-        If you wish to make comments regarding this document, please send
-        them to <a href="mailto:public-html-a11y@w3.org">public-html-a11y@w3.org</a>
-        (<a href="mailto:public-html-a11y-request@w3.org?subject=subscribe">subscribe</a>,
-        <a href="http://lists.w3.org/Archives/Public/public-html-a11y/">archives</a>).
-All
-        feedback is welcome. Bugs can also be filed directly into the <a href="https://www.w3.org/Bugs/Public/buglist.cgi?product=HTML%20WG&amp;amp;component=HTML%20Image%20Description%20Extension">W3C
-          Bug tracker for this specification</a>. This Candidate
-        Recommendation is expected to advance to Proposed Recommendation no earlier
-        than 07 August 2014.</p>
-      <p>Following feedback on the <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130312/">First
-          Public Working Draft</a>, a number of <a href="https://www.w3.org/Bugs/Public/buglist.cgi?product=HTML%20WG&amp;amp;component=HTML%20Image%20Description%20Extension">bugs</a>
-        were raised and resolved and a <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130606/">Second
-          Public Working Draft</a> was published for review. Review of this
-        draft did not produce any new substantive issues, and a
-        <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130716/">Last Call Working Draft</a>
-        was published. Comments on that draft
-        <a href="http://www.w3.org/WAI/PF/HTML/longdesc/comment-disposition.html">were resolved</a>,
-        resulting in this draft.</p>
-      <p>Significant changes between successive public drafts are tracked in the
-        <a href="#changes">Change History section</a>. Note that this will become a separate document on publication of a CR</p>
-      <p>This document is intended to become a <abbr title="World Wide Web Consortium">W3C</abbr>
-        Recommendation.
-      </p>
-      <p> Publication as a Candidate Recommendation does not imply endorsement by the <abbr
-          title="World Wide Web Consortium">W3C</abbr>
-        Membership. This is a draft document and may be updated, replaced or
-        obsoleted by other documents at any time. It is inappropriate to cite
-        this document as other than work in progress. </p>
-      <p> This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
-          February 2004 <abbr title="World Wide Web Consortium">W3C</abbr>
-          Patent Policy</a>. <abbr title="World Wide Web Consortium">W3C</abbr>
-        maintains a <a href="http://www.w3.org/2004/01/pp-impl/40318/status" rel="disclosure">public
-          list of any patent disclosures</a> made in connection with the
-        deliverables of the group; that page also includes instructions for
-        disclosing a patent. An individual who has actual knowledge of a patent
-        which the individual believes contains <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential
-          Claim(s)</a> must disclose the information in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
-          6</a> of the <abbr title="World Wide Web Consortium">W3C</abbr>
-        Patent Policy. </p>
+      <p>This is an editor's draft and has no official standing.</p>
     </section>
     <section id="toc">
       <h2 class="introductory">Table of Contents</h2>
@@ -432,7 +386,7 @@
       </ul>
     </section>
     <section id="intro" class="introductory">
-      <h1>Introduction</h1>
+      <h2>Introduction</h2>
 
       <p>Text alternatives are used to make visual information accessible by describing
         the information or function represented in an image.  The <code>alt</code>
@@ -642,7 +596,7 @@
         <p>The <code>longdesc</code> attribute <em class="rfc2119">must</em>
           contain a <a href="http://www.w3.org/TR/html5/infrastructure.html#valid-url-potentially-surrounded-by-spaces">valid
             non-empty URL potentially surrounded by spaces</a>. The URL is a <a
-            href="http://dev.w3.org/html5/spec/links.html#hyperlink">hyperlink</a>
+            href="http://www.w3.org/TR/html5/links.html#hyperlink">hyperlink</a>
           to a description of the image that the parent <code>img</code>
           element represents. </p>
         <p>The linked description <em class="rfc2119">should</em> be in a
@@ -668,6 +622,12 @@
         <p>When a description is only part of the target document, authors
           <em class="rfc2119">should</em> link to a container element in the target
           document that contains the entire description.</p>
+        <div class="note" role="region" aria-label="informative">
+          <p><em>This section is informative</em></p>
+          <p>Note that while in some cases this will allow user agents to present the
+          description, there will be cases where user agents cannot or do not
+	  automatically restrict the information presented to the container element.
+        </div>
           <div class="example" role="region" aria-label="example">
             <pre>
 <span class="informative">Example: (Informative)</span>
@@ -702,8 +662,15 @@
           make the link available to all users through the regular user
           interface(s).&nbsp; </p>
         <p>If the <code>longdesc</code> value is valid, User agents <em class="rfc2119">must</em>
-          expose the link to relevant APIs, especially accessibility-oriented
-          APIs. </p>
+          expose the longdesc to relevant APIs, especially accessibility-oriented
+          APIs, in a manner most appropriate to the API. </p>
+        <div class="note" role="region" aria-label="informative">
+          <p><em>This section is informative</em></p>
+          <p>What is most appropriate to an API will vary with the
+          individual API. Some APIs (like MSAA) will need the text string which
+          constitutes the URL of the longdesc value.
+          Other APIs may provide an actionable interface.</p>
+        </div>
         <p>User agents <em class="rfc2119">should</em> enable users to discover
           when images in a page contain a long description.</p>
         <div class="note" role="region" aria-label="informative">
@@ -735,15 +702,15 @@
 class="idlInterfaceID">HTMLImageElement</span> {
 <span class="idlAttribute">             attribute <span class="idlAttrType"><a>DOMString</a></span> <span
 class="idlAttrName"><a
-href="#widl-Element-longdesc">longdesc</a></span>;</span>
+href="#widl-Element-longdesc">longDesc</a></span>;</span>
 };</span></pre>
         <section id="attributes">
           <h4><span class="secno">3.1.1 </span>Attribute</h4>
           <dl class="attributes">
-            <dt id="widl-Element-longdesc"><code>longdesc</code> of type <span
+            <dt id="widl-Element-longdesc"><code>longDesc</code> of type <span
                 class="idlAttrType"><a>DOMString</a></span></dt>
             <dd>
-              <p class="rfc2119">The <dfn id="dfn-dom-element-longdesc"><code>longdesc</code></dfn>
+              <p class="rfc2119">The <dfn id="dfn-dom-element-longdesc"><code>longDesc</code></dfn>
                 IDL attribute <em class="rfc2119">must</em> be a valid
                 non-empty URL potentially surrounded by spaces. It defines a
                 hyperlink to a detailed description of the image its parent <code><a
@@ -753,7 +720,7 @@
                 represents.</p>
             </dd>
             <dd>
-              <p>The <code>longdesc</code> IDL attribute <em class="rfc2119">must</em>
+              <p>The <code>longDesc</code> IDL attribute <em class="rfc2119">must</em>
                 <a href="http://www.w3.org/TR/html5/infrastructure.html#reflect">reflect</a>
                 the HTML content attribute <code>longdesc</code>. </p>
             </dd>
@@ -761,7 +728,7 @@
               <dl class="note">
                 <dt>
                   <p><em>This section is informative</em></p>
-                  <p><var>image</var>.<code title="dom-Element-innerHTML">longdesc</code>
+                  <p><var>image</var>.<code title="dom-Element-innerHTML">longDesc</code>
                     [ = <var>value</var> ]</p>
                 </dt>
                 <dd>
@@ -782,7 +749,7 @@
 var baseURL = document.location.origin + document.location.pathname
 var someImage = document.querySelector('img[longdesc^=#]');
 
-someImage.longdesc = baseURL + someImage.longdesc;</code></pre>
+someImage.longDesc = baseURL + someImage.longDesc;</code></pre>
             </div>
             <div class="example" role="region" aria-label="example">
               <pre class="example">
@@ -794,7 +761,7 @@
 
 for (i in describedImages) {
   if (i.longdesc)
-    window.open(i.longdesc);
+    window.open(i.longDesc);
 }</code></pre>
             </div>
             <div class="example" role="region" aria-label="example">
@@ -806,11 +773,11 @@
 var describedImages = document.querySelectorAll('img[longdesc]');
 
 for (i in describedImages) {
-  if (i.longdesc &amp;&amp; !(validURL(i.longdesc)) { //assumes some URL validating function
-    var theData = encodeURIComponent(i.longdesc);
-    i.longdesc = "data:text/plain;charset=";
-    i.longdesc += document.charset;
-    i.longdesc += theData;
+  if (i.longDesc &amp;&amp; !(validURL(i.longDesc)) { //assumes some URL validating function
+    var theData = encodeURIComponent(i.longDesc);
+    i.longDesc = "data:text/plain;charset=";
+    i.longDesc += document.charset;
+    i.longDesc += theData;
   }
 }</code></pre>
 </div>
@@ -828,8 +795,8 @@
           tables, coffee breaks, and elsewhere) for the ideas, discussions and
           contributions that led to the initial draft of this specification.
           With the exception of Laura Carlson, who did far more very valuable
-          work than it took me to produce this specification, I haven't named
-          them: the list might be larger than the content of the specification.</p>
+	  work than it took to produce this specification, they are not individually
+	  named: the list might be larger than the content of the specification.</p>
         <p>For specific comments and suggestions that led to improvements over
           successive drafts of this specification, thanks to the W3C's HTML
           Accessibility Task Force, the W3C Internationalization Working Group,
@@ -840,6 +807,13 @@
           Leif Halvard Silli, Mathew Turvey, Klaas 'Z4us' V, and Boris Zbarsky.
           The code examples are rendered with Lea Verou's prism tools. Any
           errors are despite, not as a result of, their efforts.</p>
+	<p>This publication has been funded in part with Federal funds from the
+	  U.S. Department of Education, National Institute on Disability and
+	  Rehabilitation Research (NIDRR) under contract ED-OSE-10-C-0067. The
+	  content of this publication does not necessarily reflect the views or
+	  policies of the U.S. Department of Education, nor does mention of
+	  trade names, commercial products, or organizations imply endorsement
+	  by the U.S. Government.</p>
       </section>
       <section class="appendix" id="references">
         <h2><span class="secno">B. </span>References</h2>
@@ -847,17 +821,17 @@
           <h3><span class="secno">B.1 </span>Normative References</h3>
           <dl class="bibliography">
             <dt id="bib-HTML5">[HTML5]</dt>
-            <dd>Robin Berjon et. al., eds. <a href="http://www.w3.org/TR/html5/"><cite>HTML5.</cite></a>
-              W3C Working Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
+            <dd>Ian Hickson; Robin Berjon; Steve Faulkner; Travis Leithead; Erika Doyle Navara; Edward O'Connor; Silvia Pfeiffer. <a href="http://www.w3.org/TR/html5/"><cite>HTML5.</cite></a>
+              28 October 2014. W3C Recommendation. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
             </dd>
             <dt id="bib-RFC2119">[RFC2119]</dt>
             <dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key
                   words for use in RFCs to Indicate Requirement Levels.</cite></a>
               March 1997. Internet RFC 2119. URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a></dd>
             <dt id="bib-WEBIDL">[WEBIDL]</dt>
-            <dd>Cameron McCormack. <a href="http://www.w3.org/TR/2011/WD-WebIDL-20110927/"><cite>Web
-                  IDL.</cite></a> 27 September 2011. W3C Working Draft. (Work in
-              progress.) URL: <a href="http://www.w3.org/TR/2011/WD-WebIDL-20110927/">http://www.w3.org/TR/2011/WD-WebIDL-20110927/</a></dd>
+            <dd>Cameron McCormack. <a href="http://www.w3.org/TR/2012/CR-WebIDL-20120419/"><cite>Web
+                  IDL.</cite></a> 19 April 2012. W3C Working Draft. (Work in
+              progress.) URL: <a href="http://www.w3.org/TR/2012/CR-WebIDL-20120419/">http://www.w3.org/TR/2012/CR-WebIDL-20120419/</a></dd>
           </dl>
         </section>
         <section id="informative-references">