- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 14 Dec 2011 11:52:33 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/canvas-extensions
In directory hutz:/tmp/cvs-serv27556
Modified Files:
Overview.html
Log Message:
updated
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/canvas-extensions/Overview.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- Overview.html 14 Dec 2011 11:04:55 -0000 1.7
+++ Overview.html 14 Dec 2011 11:52:31 -0000 1.8
@@ -162,7 +162,7 @@
<code><a href="#canvasrenderingcontext2d">CanvasRenderingContext2D</a></code>
interface.</p>
-<p>Conforming user agents <em title="must" class="rfc2119">must</em> implement the
+<p>Conforming user agents <em title="must" class="rfc2119">MUST</em> implement the
<code><a href="#canvasrenderingcontext2d">CanvasRenderingContext2D</a></code>
interface as specified in the following IDL definition.</p>
@@ -288,15 +288,15 @@
<div class="section" id="focus-management-1">
<!--OddPage--><h2 id="focus-management"><span class="secno">5. </span>Focus management</h2>
-<p>When a canvas is interactive, authors should include focusable
+<p>When a canvas is interactive, authors SHOULD include focusable
elements in the element's fallback content corresponding to each
focusable part of the canvas.</p><p>To indicate which focusable part of the canvas is currently
- focused, authors should use the <code title="dom-context-2d-drawFocusRing"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-drawfocusring">drawFocusRing()</a></code> method,
+ focused, authors SHOULD use the <code title="dom-context-2d-drawFocusRing"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-drawfocusring">drawFocusRing()</a></code> method,
passing it the element for which a ring is being drawn.
This method
only draws the focus ring if the element is focused or is a descendant
- of the element with focus. </p><dl class="domintro"><dt><var title="">shouldDraw</var> = <var title="">context</var> . <code title="dom-context-2d-drawFocusRing"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-drawfocusring">drawFocusRing</a></code>(<var title="">element</var>, [ <var title="">canDrawCustom</var> ])</dt>
+ of the element with focus. </p><dl class="domintro"><dt><var title="">SHOULDDraw</var> = <var title="">context</var> . <code title="dom-context-2d-drawFocusRing"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-drawfocusring">drawFocusRing</a></code>(<var title="">element</var>, [ <var title="">canDrawCustom</var> ])</dt>
<dd>
@@ -323,19 +323,19 @@
<p>The drawing path is used to form the focus ring provided that
drawing path contains a closed path. The drawing path is used to
form a best fit bounding rectangle in screen coordinates. The
- bounding rectangle and drawing path may be used to enhance
+ bounding rectangle and drawing path MAY be used to enhance
accessibility properties
[<cite><a href="#bib-WAI-ARIA" rel="biblioentry" class="bibref">WAI-ARIA</a></cite>]
for the targeted element.</p>
<p>The <dfn id="dom-context-2d-drawfocusring" title="dom-context-2d-drawFocusRing"><code>drawFocusRing(<var title="">element</var>, [<var title="">canDrawCustom</var>])</code></dfn>
- method, when invoked, must run the following steps:</p>
+ method, when invoked, MUST run the following steps:</p>
<ol><li><p>If the <var title="">element</var> is not focused or is not a
descendant of the element with whose context the method is
associated, then return false and abort these steps.</p></li>
- <li><p>If supporting an accessibility API, implementors may use the drawing path to form a best fit rectangle in screen coordinates and apply it to the bounding rectangle of the associated accessible object. </p></li>
+ <li><p>If supporting an accessibility API, implementors MAY use the drawing path to form a best fit rectangle in screen coordinates and apply it to the bounding rectangle of the associated accessible object. </p></li>
<li>
@@ -345,8 +345,8 @@
following platform conventions, return false, and abort these
steps.</p>
- <p>The focus ring should not be subject to the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#shadows" title="shadows">shadow effects</a>, the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-globalalpha" title="dom-context-2d-globalAlpha">global alpha</a>, or the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-globalcompositeoperation" title="dom-context-2d-globalCompositeOperation">global composition
- operators</a>, but <em>should</em> be subject to the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#clipping-region" title="clipping region">clipping region</a>.</p>
+ <p>The focus ring SHOULD not be subject to the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#shadows" title="shadows">shadow effects</a>, the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-globalalpha" title="dom-context-2d-globalAlpha">global alpha</a>, or the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-globalcompositeoperation" title="dom-context-2d-globalCompositeOperation">global composition
+ operators</a>, but <em>SHOULD</em> be subject to the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#clipping-region" title="clipping region">clipping region</a>.</p>
</li>
@@ -366,7 +366,7 @@
<!--
<p class="XXX annotation"><b>Status: </b><i>Ideally setCaretSelectionRect() and caretBlinkRate() should be managed under the covers by canvas methods that draw carets or content selections. If <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=10248">defect 10248</a> and <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=10249">defect 10249</a> are accepted with the provisions for supporting accessibility services we can operate off those methods to complete to address the caret and selection position tracking component of Issue-74. </i></p>
-->
-<p>The <code title="dom-context-2d-setCaretSelectionRect"><a href="#dom-context-2d-setCaretSelectionRect">setCaretSelectionRect()</a></code> method should be used
+<p>The <code title="dom-context-2d-setCaretSelectionRect"><a href="#dom-context-2d-setCaretSelectionRect">setCaretSelectionRect()</a></code> method SHOULD be used
to indicate the location of the last rendered <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#caretpos" title="caret position">caret position</a> or <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#selectionpos" title="selection position">selection position</a> on the canvas, passing it the canvas fallback element
associated with the last drawn of either the caret position or the selection.</p>
@@ -379,7 +379,7 @@
-->
<p>
- When drawing a blinking caret the author must adhere to the blink rates in systems that support this feature. User agents must provide the system caret blink rate to content authors. Default system caret blink rate settings are roughly once every 500 milliseconds.
+ When drawing a blinking caret the author MUST adhere to the blink rates in systems that support this feature. User agents MUST provide the system caret blink rate to content authors. Default system caret blink rate settings are roughly once every 500 milliseconds.
</p>
<p>To access the system caret blink rate in canvas use the
<code title="dom-context-2d-caretBlinkRate"><a href="#dom-context-2d-caretBlinkRate">caretBlinkRate()</a></code> method</p>
@@ -421,7 +421,7 @@
<p>The <dfn id="dom-context-2d-setCaretSelectionRect" title="dom-context-2d-setCaretSelectionRect"><code>setCaretSelectionRect(<var title="">element</var>, <var title="">x</var>, <var title="">y</var>, <var title="">w</var>, <var title="">h</var>)</code></dfn>
- method, when invoked, must run the following steps:</p>
+ method, when invoked, MUST run the following steps:</p>
<ol>
<li><p>If <var title="">element</var> does not have selected content and is not focused return false and abort these steps.</p></li>
@@ -429,7 +429,7 @@
<li><p>If the element is not a descendant of the element with whose context the method is associated, then return false and abort these step.</p></li>
<li><p>Transform the given point (<var title="">x</var>, <var title="">y</var>), the width <var title="">w</var>, and the height <var title="">h</var> according to the <a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#transformations" title="dom-context-2d-transformation">current transformation matrix</a>.</p></li>
- <li><p>If the user agent supports a platform accessibility API the user agent must use the element, transformed coordinates and transformed bounding box, and provide it through the supported accessibility API implementation.
+ <li><p>If the user agent supports a platform accessibility API the user agent MUST use the element, transformed coordinates and transformed bounding box, and provide it through the supported accessibility API implementation.
<!--
The element used to determine the corresponding accessible object for purposes of supporting the accessibility API. This is for the purposes of driving screen magnification.
-->
@@ -444,7 +444,7 @@
<li><p>Return true.</p></li>
</ol></div>
- <p>If the user resizes or moves the user agent window the user agent report must reflect the revised (<var title="">x</var>, <var title="">y</var>, <var title="">w</var>, <var title="">h</var>) position (or rectangle) in the accessibility API mapping. </p>
+ <p>If the user resizes or moves the user agent window the user agent report MUST reflect the revised (<var title="">x</var>, <var title="">y</var>, <var title="">w</var>, <var title="">h</var>) position (or rectangle) in the accessibility API mapping. </p>
<div class="impl">
@@ -453,11 +453,11 @@
<p>The <dfn id="dom-context-2d-caretBlinkRate" title="dom-context-2d-blinkRate"><code>caretBlinkRate()</code></dfn>
- method, when invoked, must run the following steps:</p>
+ method, when invoked, MUST run the following steps:</p>
<ol>
- <li><p>If the operating system supports a caret blink rate setting the user agent must return a long value in milliseconds.</p></li>
- <li><p>If the operating system does not support a caret blink rate setting the user agent must return a long value less than zero.</p></li>
+ <li><p>If the operating system supports a caret blink rate setting the user agent MUST return a long value in milliseconds.</p></li>
+ <li><p>If the operating system does not support a caret blink rate setting the user agent MUST return a long value less than zero.</p></li>
</ol>
<p>
@@ -465,9 +465,9 @@
</p>
<ul>
- <li><p>For blink rates greater than zero the author, when drawing a blinking caret, must reflect the blink rate returned by this method.</p></li>
- <li><p>For a blink rate less than zero the author, when drawing a blinking caret, must determine the blink rate.</p></li>
- <li><p>For a blink rate of zero the author should visibly render the caret.</p></li>
+ <li><p>For blink rates greater than zero the author, when drawing a blinking caret, MUST reflect the blink rate returned by this method.</p></li>
+ <li><p>For a blink rate less than zero the author, when drawing a blinking caret, MUST determine the blink rate.</p></li>
+ <li><p>For a blink rate of zero the author SHOULD visibly render the caret.</p></li>
</ul>
</div>
<p>
@@ -499,15 +499,15 @@
<p>The <dfn id="dom-context-2d-measuretext" title="dom-context-2d-measureText"><code>measureText()</code></dfn>
method takes one argument, <var title="">text</var>. When the method
- is invoked, the user agent must replace all the <span title="space
+ is invoked, the user agent MUST replace all the <span title="space
character">space characters</span> in <var title="">text</var> with
- U+0020 SPACE characters, and then must form a hypothetical
+ U+0020 SPACE characters, and then MUST form a hypothetical
infinitely wide CSS line box containing a single inline box
containing the text <var title="">text</var>, with all the
properties at their initial values except the 'font' property of the
inline element set to the current font of the context, as given by
the <code title="dom-context-2d-font"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-font">font</a></code> attribute, and
- must then return a new <code><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#textmetrics">TextMetrics</a></code> object with its
+ MUST then return a new <code><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#textmetrics">TextMetrics</a></code> object with its
<code title="dom-textmetrics-width"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-textmetrics-width">width</a></code> attribute set to
the width of that inline box, in CSS pixels and its
<code title="dom-textmetrics-baseline"><a href="#dom-textmetrics-baseline">baseline</a></code> attribute
@@ -515,9 +515,10 @@
<code title="dom-context-2d-textBaseline"><a class="upstream-link" href="http://dev.w3.org/html5/2dcontext/#dom-context-2d-textbaseline">textBaseline</a></code> value,
in CSS pixels. [<cite><a href="#bib-CSS21" rel="biblioentry" class="bibref">CSS21</a></cite>]</p>
</div>
-<div class="appendix section" id="references"><!--OddPage--><h2><span class="secno">A. </span>References</h2><div class="section" id="normative-references"><h3><span class="secno">A.1 </span>Normative references</h3><dl class="bibliography"><dt id="bib-CANVAS-2D">[CANVAS-2D]</dt><dd>Ian Hickson. <a href="http://www.w3.org/TR/2dcontext/"><cite>HTML Canvas 2D Context.</cite></a> 25 May 2011. W3C Working Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/2dcontext/">http://www.w3.org/TR/2dcontext/</a>
-</dd><dt id="bib-CSS21">[CSS21]</dt><dd>Bert Bos; et al. <a href="http://www.w3.org/TR/CSS21/"><cite>Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification.</cite></a>. W3C Recommendation. URL: <a href="http://www.w3.org/TR/CSS21">http://www.w3.org/TR/CSS21/</a>
-</dd><dt id="bib-HTML5">[HTML5]</dt><dd>Ian Hickson; David Hyatt. <a href="http://www.w3.org/TR/2011/WD-html5-20110525/"><cite>HTML5.</cite></a> 25 May 2011. W3C Working Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/2011/WD-html5-20110525/">http://www.w3.org/TR/2011/WD-html5-20110525/</a>
+<div class="appendix section" id="references"><!--OddPage--><h2><span class="secno">A. </span>References</h2><div class="section" id="normative-references"><h3><span class="secno">A.1 </span>Normative references</h3><dl class="bibliography"><dt id="bib-CANVAS-2D">[CANVAS-2D]</dt><dd>Ian Hickson. <a href="http://dev.w3.org/html5/2dcontext/Overview.html"><cite>HTML Canvas 2D Context.</cite></a> URL:<a href="http://dev.w3.org/html5/2dcontext/Overview.html">http://dev.w3.org/html5/2dcontext/Overview.html</a></dd>
+ <dt id="bib-CSS21">[CSS21]</dt><dd>Bert Bos; et al. <a href="http://www.w3.org/TR/CSS21/"><cite>Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification.</cite></a>. W3C Recommendation. URL: <a href="http://www.w3.org/TR/CSS21">http://www.w3.org/TR/CSS21/</a>
+</dd><dt id="bib-HTML5">[HTML5]</dt>
+<dd>Ian Hickson; David Hyatt. <a href="http://dev.w3.org/html5/spec/"><cite>HTML5.</cite></a> URL: <a href="http://dev.w3.org/html5/spec/">http://dev.w3.org/html5/spec/</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/2008/WD-WebIDL-20081219"><cite>Web IDL.</cite></a> 19 December 2008. W3C Working Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/2008/WD-WebIDL-20081219">http://www.w3.org/TR/2008/WD-WebIDL-20081219</a>
</dd></dl></div><div class="section" id="informative-references"><h3><span class="secno">A.2 </span>Informative references</h3><dl class="bibliography"><dt id="bib-WAI-ARIA">[WAI-ARIA]</dt><dd>Lisa Pappas; et al. <a href="http://www.w3.org/TR/2009/WD-wai-aria-20090224"><cite>Accessible Rich Internet Applications (WAI-ARIA) 1.0.</cite></a> 24 February 2009. W3C Working Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/2009/WD-wai-aria-20090224">http://www.w3.org/TR/2009/WD-wai-aria-20090224</a>
Received on Wednesday, 14 December 2011 11:52:39 UTC