W3C home > Mailing lists > Public > public-html-commits@w3.org > September 2012

html5/2dcontext Overview.html,1.165,1.166

From: Sam Ruby via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 19 Sep 2012 13:31:16 +0000
To: public-html-commits@w3.org
Message-Id: <E1TEKN2-0007jt-JN@lionel-hutz.w3.org>
Update of /sources/public/html5/2dcontext
In directory hutz:/tmp/cvs-serv29731

Modified Files:
	Overview.html 
Log Message:
commit ff71259363203c8288d6d8f361d9fc800dbf5078
Author: Erika Doyle Navara <erika.doyle@microsoft.com>
Date:   Tue Sep 18 16:25:55 2012 -0700

    [HTML5 Bug 18904]: change text in 'status of this document' to remove inaccuracies
    
    In order to prepare the upcoming heartbeat draft while still acting in
    deference to the open status of ISSUE-151, making the minimal amount of
    changes to clear up inaccuracies as to where to find the latest stable
    version of the spec and our W3C feedback channels.


Index: Overview.html
===================================================================
RCS file: /sources/public/html5/2dcontext/Overview.html,v
retrieving revision 1.165
retrieving revision 1.166
diff -u -d -r1.165 -r1.166
--- Overview.html	15 Sep 2012 00:43:23 -0000	1.165
+++ Overview.html	19 Sep 2012 13:31:14 -0000	1.166
@@ -62,6 +62,9 @@
    .diff-chg, .diff-new { text-decoration: underline; color: green; background: transparent; }
    a .diff-new { border-bottom: 1px blue solid; }
 
+   figure.diagrams { border: double black; background: white; padding: 1em; }
+   figure.diagrams img { display: block; margin: 1em auto; } 
+
    h2 { page-break-before: always; }
    h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
    h1 + h2, hr + h2.no-toc { page-break-before: auto; }
@@ -278,23 +281,23 @@
 
    @font-face {
      font-family: 'Essays1743';
-     src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743.ttf');
+     src: url('../fonts/Essays1743.ttf');
    }
    @font-face {
      font-family: 'Essays1743';
      font-weight: bold;
-     src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743-Bold.ttf');
+     src: url('../fonts/Essays1743-Bold.ttf');
    }
    @font-face {
      font-family: 'Essays1743';
      font-style: italic;
-     src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743-Italic.ttf');
+     src: url('../fonts/Essays1743-Italic.ttf');
    }
    @font-face {
      font-family: 'Essays1743';
      font-style: italic;
      font-weight: bold;
-     src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743-BoldItalic.ttf');
+     src: url('../fonts/Essays1743-BoldItalic.ttf');
    }
 
   </style><link href=data:text/css, id=complete rel=stylesheet title="Complete specification"><link href=data:text/css,.impl%20{%20display:%20none;%20}%0Ahtml%20{%20border:%20solid%20yellow;%20}%20.domintro:before%20{%20display:%20none;%20} id=author rel="alternate stylesheet" title="Author documentation only"><link href=data:text/css,.impl%20{%20background:%20%23FFEEEE;%20}%20.domintro:before%20{%20background:%20%23FFEEEE;%20} id=highlight rel="alternate stylesheet" title="Highlight implementation requirements"><script>
@@ -321,7 +324,7 @@
 
    <h1>HTML Canvas 2D Context</h1>
    <h2 class="no-num no-toc" id=generatedID></h2>
-   <h2 class="no-num no-toc" id="editor's-draft-date-1-january-1970">Editor's Draft 15 September 2012</h2>
+   <h2 class="no-num no-toc" id="editor's-draft-date-1-january-1970">Editor's Draft 19 September 2012</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href=http://www.w3.org/TR/2dcontext/>http://www.w3.org/TR/2dcontext/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -378,82 +381,28 @@
   
   <!-- intro boilerplate (required) -->
 
-  <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 W3C publications and the
-
-  most recently formally published <!-- DO NOT CHANGE THIS BACK TO THE STANDARD BOILERPLATE, AS IT IS INACCURATE -->
-
-  revision of this technical report can be found in the <a href=http://www.w3.org/TR/>W3C technical reports index</a> at
-  http://www.w3.org/TR/.</em></p>
+  <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 W3C publications and the latest revision of this technical report can be found in the <a href=http://www.w3.org/TR/>W3C technical reports index</a> at http://www.w3.org/TR/.</em></p>
 
 
   <!-- where to send feedback (required) -->
 
   <p>If you wish to make comments regarding this document in a manner
   that is tracked by the W3C, please submit them via using <a href="http://www.w3.org/Bugs/Public/enter_bug.cgi?product=HTML%20WG">our
-  public bug database</a>. If you do not have an account then you can
-  enter feedback using this form:</p>
-
-  <form action=http://www.whatwg.org/specs/web-apps/current-work/file-spam.cgi method=post>
-   <fieldset><legend>Feedback Comments</legend>
-    <input name=id type=hidden value=top><input name=component type=hidden value="HTML Canvas 2D Context (editor: Ian Hickson)"><input name=response type=hidden value=html><p><label for=feedbackBox>Please enter your feedback, carefully
-    indicating the title of the section for which you are submitting
-    feedback, quoting the text that's wrong today if appropriate. If
-    you're suggesting a new feature, it's really important to say
-    <em>what</em> the problem you're trying to solve is. That's more
-    important than the solution, in fact.</label></p>
-    <p><textarea cols=79 id=feedbackBox name=text rows=10></textarea></p>
-    <p class=note>Please don't use section numbers as these tend to
-    change rapidly and make your feedback harder to understand.</p>
-    <script>
-    function checkFeedbackForm(form) {
-      if (form.elements.text.value.match(/^ *</)) {
-        alert('Please don\'t start your feedback with an angle bracket, instead explain what topic your feedback is about first.');
-        return true;
-      } else if (form.elements.text.value.match(/ [^ ]+ [^ ]+ [^ ]+ [^ ]+ /)) {
-        if (form.elements.text.value.match(/^Please enter your feedback, carefully/)) {
-          alert('Please enter your feedback, explaining what is wrong, and without repeating the instructions. Thanks!');
-          return true;
-        } else if (form.elements.text.value.match(/ [^ ]+ [^ ]+ [^ ]+ [^ ]+ /)) {
-          form.action = "http://www.whatwg.org/specs/web-apps/current-work/file-bug.cgi";
-          return true;
-        } else {
-          alert('Please include significantly more detail about exactly what problem you are trying to solve.');
-          return false;
-        }
-      }
-    }
-    </script><p>
-     <input onclick="return checkFeedbackForm(form)" type=submit value="Submit feedback"><small>(Note: Your IP address and user agent will be publicly recorded for spam prevention purposes.)</small>
-    </p>
-   </fieldset></form>
-
-  
-  <p>If you cannot do this then you can also e-mail feedback to <a href=mailto:public-html-comments@w3.org>public-html-comments@w3.org</a>
+  public bug database</a>. If you cannot do this then you can also e-mail feedback to <a href=mailto:public-html-comments@w3.org>public-html-comments@w3.org</a>
   (<a href="mailto:public-html-comments-request@w3.org?subject=subscribe">subscribe</a>,
   <a href=http://lists.w3.org/Archives/Public/public-html-comments/>archives</a>),
   and arrangements will be made to transpose the comments to our
-  public bug database.
-
-  <!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING SENTENCE TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->  
-  Alternatively, you can e-mail feedback to <a href=mailto:whatwg@whatwg.org>whatwg@whatwg.org</a> (<a href=http://lists.whatwg.org/listinfo.cgi/whatwg-whatwg.org>subscribe</a>,
-  <a href=http://lists.whatwg.org/pipermail/whatwg-whatwg.org/>archives</a>).
-  The editor guarantees that all substantive feedback sent to this
-  list will receive a reply. However, such feedback is not considered
-  formal feedback for the W3C process.
-  <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING SENTENCE TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
+  public bug database. All feedback is welcome.</p>
 
-  All feedback is welcome.</p>
+  
 
+  
   <!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->  
-  <p>The working groups maintains <a href="http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr&amp;long_desc=&amp;bug_file_loc_type=allwordssubstr&amp;bug_file_loc=&amp;status_whiteboard_type=allwordssubstr&amp;status_whiteboard=&amp;keywords_type=allwords&amp;keywords=&amp;bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;emailassigned_to1=1&amp;emailtype1=exact&amp;email1=ian%40hixie.ch&amp;emailtype2=substring&amp;email2=&amp;bugidtype=include&amp;bug_id=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;cmdtype=doit&amp;order=Reuse+same+sort+as+last+time&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=">a
-  list of all bug reports that the editor has not yet tried to
+  <p>The working groups maintains <a href="http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;product=HTML+WG&amp;longdesc_type=allwordssubstr&amp;longdesc=&amp;bug_file_loc_type=allwordssubstr&amp;bug_file_loc=&amp;status_whiteboard_type=allwordssubstr&amp;status_whiteboard=&amp;keywords_type=allwords&amp;keywords=&amp;bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;emailtype1=substring&amp;email1=&amp;emailtype2=substring&amp;email2=&amp;bug_id_type=anyexact&amp;bug_id=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;cmdtype=doit&amp;order=Reuse+same+sort+as+last+time&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=">a
+  list of all bug reports that the editors have not yet tried to
   address</a> and <a href=http://www.w3.org/html/wg/tracker/products/1>a list of issues
-  for which the chairs have not yet declared a decision</a>. The
-  editor also maintains <a href=http://www.whatwg.org/issues/>a list
-  of all e-mails that he has not yet tried to address</a>. These bugs,
-  issues, and e-mails apply to multiple HTML-related specifications,
+  for which the chairs have not yet declared a decision</a>. These bugs and
+  issues apply to multiple HTML-related specifications,
   not just this one.</p>
   <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
 
@@ -472,26 +421,15 @@
   </div>
 
 
-  <!-- not everyone agrees with this (requested before html5 fpwd) -->
-  <p>The publication of this document by the W3C as a W3C Working
-  Draft does not imply that all of the participants in the W3C HTML
-  working group endorse the contents of the specification. Indeed, for
-  any section of the specification, one can usually find many members
-  of the working group or of the W3C as a whole who object strongly to
-  the current text, the existence of the section at all, or the idea
-  that the working group should even spend time discussing the concept
-  of that section.</p>
+  <p>Publication as a Working Draft does not imply endorsement by the W3C 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>
 
 
   <!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
   <!-- version history or list of changes (required) -->
   <p>The latest stable version of the editor's draft of this
-  specification is always available on <a href=http://dev.w3.org/html5/>the W3C CVS server</a> and in the <a href=http://svn.whatwg.org/webapps/>WHATWG Subversion
-  repository</a>. The <a href=http://www.whatwg.org/specs/web-apps/current-work/complete.html>latest
-  editor's working copy</a> (which may contain unfinished text in the
-  process of being prepared) contains the latest draft text of this
-  specification (amongst others). For more details, please see the <a href=http://wiki.whatwg.org/wiki/FAQ#What_are_the_various_versions_of_the_spec.3F>WHATWG
-  FAQ</a>.</p>
+  specification is always available on <a href=http://dev.w3.org/html5/>the W3C CVS server</a>.</p>
   <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
 
   <!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING LIST TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
@@ -509,7 +447,7 @@
   Group</a> is the W3C working group responsible for this
   specification's progress along the W3C Recommendation
   track.
-  This specification is the 15 September 2012 Editor's Draft.
+  This specification is the 19 September 2012 Editor's Draft.
   </p>
 
 
@@ -4558,15 +4496,10 @@
 
      <li>The <a href=#path>path</a> <var title="">source path</var>
      describes a shape with no pixels.</li>
-
-     <li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-control>control</code> member is not
-     null but is neither an <code>a</code> element that
-     <span>represents</span> a <span>hyperlink</span>, a
-     <code>button</code> element, an <code>input</code> element whose
-     <code title=attr-input-type>type</code> attribute is in one of
-     the <span title=attr-input-type-checkbox>Checkbox</span> or
-     <span title=attr-input-type-radio>Radio Button</span> states,
-     nor an <code>input</code> element that is a <span title=concept-button>button</span>.</li>
+     
+     <li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-control>control</code> member is not 
+     null and is not an element that is a descendant of this <code>
+     canvas</code> element.</li>
 
      <li>The <var title="">parent region</var> is not null but has a
      <a href="#hit-region's-control" title="hit region's control">control</a>.</li>
@@ -4732,7 +4665,28 @@
    <li><p>Add <var title="">region</var> to the <code>canvas</code>
    element's <a href=#hit-region-list>hit region list</a>.</p></li>
 
-  </ol><p>When the <dfn id=dom-context-2d-removehitregion title=dom-context-2d-removeHitRegion><code>removeHitRegion()</code></dfn>
+  </ol><p>If the <a href=#hit-region title="hit region">hitregion</a> is interactive 
+  or requires the use of WAI-ARIA states or properties (in addition to
+  role or label), authors must not use an unbacked <var title="">
+  region</var> description (as there is no method to attach WAI-ARIA 
+  states or properties to an  unbacked <var title="">region</var> 
+  description and unbacked <var title="">region</var> are unable to 
+  receive focus and therefore cannot be in a focused state).</p>
+  
+  <p>In cases where the <var title="">region</var> is functioning as an 
+  interactive control it must have a <code title=dom-HitRegionOptions-control>control</code>. It is recommended 
+  that the control() references an <code>html</code> <code title="Interactive content">interactive element</code> unless <code>html
+  </code> does not provide the desired features. In which case WAI-ARIA 
+  role, states and properties may be used as allowed in <code>html</code>.</p>
+  
+  <p> Examples of <var title="">regions</var> where a WAI-ARIA role requires 
+  keyboard focus or the use of WAI-ARIA states and properties other than
+  label, are a button and a checkbox. A button has a role="button" and it 
+  is required to be focusable using the keyboard. A checkbox has a role
+  ="checkbox", requires an aria-checked state and it is required to be 
+  focusable using the keyboard. <a href=#refsARIA>[ARIA]</a></p>
+
+  <p>When the <dfn id=dom-context-2d-removehitregion title=dom-context-2d-removeHitRegion><code>removeHitRegion()</code></dfn>
   method is invoked, the user agent must run the following steps:</p>
 
   <ol><li><p>Let <var title="">region</var> be <a href=#the-region-identified-by-the-id>the region
Received on Wednesday, 19 September 2012 13:31:18 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 19 September 2012 13:31:18 GMT