[html5] r1584 - /
whatwg at whatwg.org
whatwg at whatwg.org
Fri May 9 01:02:16 PDT 2008
Author: ianh
Date: 2008-05-09 01:02:15 -0700 (Fri, 09 May 2008)
New Revision: 1584
Modified:
index
source
Log:
[c] (0) Reword all conformance requirements never to use the phrase 'must only', which really doesn't mean what you think it means if you apply RFC2119 definitions precisely.
Modified: index
===================================================================
--- index 2008-05-09 07:52:23 UTC (rev 1583)
+++ index 2008-05-09 08:02:15 UTC (rev 1584)
@@ -6111,8 +6111,8 @@
the <code title=lang>lang</code> attribute represents the language of the
content.
- <p>Authors must only use elements, attributes, and attribute values for
- their appropriate semantic purposes.
+ <p>Authors must not use elements, attributes, and attribute values for
+ purposes other than their appropriate intended semantic purpose.
<div class=example>
<p>For example, the following document is non-conforming, despite being
@@ -6190,9 +6190,7 @@
<p>All the elements in this specification have a defined content model,
which describes what nodes are allowed inside the elements, and thus what
- the structure of an HTML document or fragment must look like. Authors must
- only put elements inside an element if that element allows them to be
- there according to its content model.
+ the structure of an HTML document or fragment must look like.
<p class=note>As noted in the conformance and terminology sections, for the
purposes of determining if an element matches its content model or not, <a
@@ -6457,10 +6455,10 @@
part of the content model that must be satisfied.
<p>When a content model includes a part that is "transparent", those parts
- must only contain content that would still be conformant if all
- transparent and semi-transparent elements in the tree were replaced, in
- their parent element, by the children in the "transparent" part of their
- content model, retaining order.
+ must not contain content that would not be conformant if all transparent
+ and semi-transparent elements in the tree were replaced, in their parent
+ element, by the children in the "transparent" part of their content model,
+ retaining order.
<p>When a transparent or semi-transparent element has no parent, then the
part of its content model that is "transparent" must instead be treated as
@@ -7713,9 +7711,9 @@
<p>However, if the link is an <a href="#links1">external resource link</a>,
then the <code title=attr-link-media><a href="#media0">media</a></code>
- attribute is prescriptive. The user agent must only apply the external
- resource to <span>views</span><!-- XXX xref --> while their state match
- the listed media.
+ attribute is prescriptive. The user agent must apply the external resource
+ to <span>views</span><!-- XXX xref --> while their state match the listed
+ media, and must not apply them otherwise.
<p id=default-media>The default, if the <code title=attr-link-media><a
href="#media0">media</a></code> attribute is omitted, is <code>all</code>,
@@ -8559,8 +8557,9 @@
<p>The <dfn id=media2 title=attr-style-media><code>media</code></dfn>
attribute says which media the styles apply to. The value must be a valid
<a href="#mq">media query</a>. <a href="#refsMQ">[MQ]</a> User agents must
- only apply the styles to <span>views</span> while their state match the
- listed media. <a href="#refsDOM3VIEWS">[DOM3VIEWS]</a>
+ apply the styles to <span>views</span> while their state match the listed
+ media, and must not apply them otherwise. <a
+ href="#refsDOM3VIEWS">[DOM3VIEWS]</a>
<p id=style-default-media>The default, if the <code
title=attr-style-media><a href="#media2">media</a></code> attribute is
@@ -8569,10 +8568,10 @@
<p>The <dfn id=scoped title=attr-style-scoped><code>scoped</code></dfn>
attribute is a <a href="#boolean0">boolean attribute</a>. If the attribute
- is present, then the user agent must only apply the specified style
- information to the <code><a href="#style1">style</a></code> element's
- parent element (if any), and that element's child nodes. Otherwise, the
- specified styles must, if applied, be applied to the entire document.
+ is present, then the user agent must apply the specified style information
+ only to the <code><a href="#style1">style</a></code> element's parent
+ element (if any), and that element's child nodes. Otherwise, the specified
+ styles must, if applied, be applied to the entire document.
<p>If the <code title=attr-style-scoped><a href="#scoped">scoped</a></code>
attribute is not specified, the <code><a href="#style1">style</a></code>
@@ -9845,7 +9844,7 @@
inside <code><a href="#br">br</a></code> elements must not be considered
part of the surrounding text.
- <p><code><a href="#br">br</a></code> elements must only be used for line
+ <p><code><a href="#br">br</a></code> elements must be used only for line
breaks that are actually part of the content, as in poems or addresses.
<div class=example>
@@ -11459,7 +11458,7 @@
<p>If the <code title=attr-dfn-title><a href="#title4">title</a></code>
attribute of the <code><a href="#dfn">dfn</a></code> element is present,
- then it must only contain the term being defined.
+ then it must contain only the term being defined.
<p class=note>The <code title=attr-title><a href="#title">title</a></code>
attribute of ancestor elements does not affect <code><a
@@ -12576,7 +12575,7 @@
and the <code><a href="#sub">sub</a></code> element represents a
subscript.
- <p>These elements must only be used to mark up typographical conventions
+ <p>These elements must be used only to mark up typographical conventions
with specific meanings, not for typographical presentation for
presentation's sake. For example, it would be inappropriate for the
<code><a href="#sub">sub</a></code> and <code><a
@@ -15554,8 +15553,8 @@
resource (within the constraints put forward by this and other
specifications); for example, reconnecting to the server in the face of
network errors, using HTTP partial range requests, or switching to a
- streaming protocol. The user agent must only consider a resource
- erroneous if it has given up trying to download it.</p>
+ streaming protocol. The user agent must consider a resource erroneous
+ only if it has given up trying to download it.</p>
<dl class=switch>
<dt>If the <a href="#media7">media data</a> cannot be downloaded at all,
@@ -17997,7 +17996,7 @@
</dl>
<p>These values are all case-sensitive — they must be used exactly as
- shown. User agents must only recognise values that exactly match the
+ shown. User agents must not recognise values that do not exactly match the
values given above.
<p>The operators in the above list must be treated as described by the
@@ -18217,7 +18216,7 @@
the cone after the end circle (1.0) using the color of the last offset,
and areas outside the cone untouched by the gradient (transparent black).
- <p>Gradients must only be painted where the relevant stroking or filling
+ <p>Gradients must be painted only where the relevant stroking or filling
effects requires that they be drawn.</p>
<!--
<p>Support for actually painting gradients is optional. Instead of
@@ -18279,9 +18278,9 @@
<code>repeat-y</code> string was specified) or in all four directions all
over the canvas (if the <code>repeat</code> string was specified). The
images are not scaled by this process; one CSS pixel of the image must be
- painted on one coordinate space unit. Of course, patterns must only
- actually painted where the stroking or filling effect requires that they
- be drawn, and are affected by the current transformation matrix.
+ painted on one coordinate space unit. Of course, patterns must actually be
+ painted only where the stroking or filling effect requires that they be
+ drawn, and are affected by the current transformation matrix.
<p>When the <code title=dom-context-2d-createPattern><a
href="#createpattern">createPattern()</a></code> method is passed, as its
@@ -25083,7 +25082,7 @@
as the second, and the checkbox's new state as the third. The state should
be represented by the number 1 if the new state is checked, 0 if the new
state is unchecked, and −1 if the new state is indeterminate (which
- must only be possible if the cell has the <code
+ must be possible only if the cell has the <code
title=datagrid-cell-class-indeterminate><a
href="#indeterminate">indeterminate</a></code> class set). The <code><a
href="#datagrid0">datagrid</a></code> must act as if the <code><a
@@ -25204,9 +25203,9 @@
<p>If the <code><a href="#datagrid0">datagrid</a></code> element has a <dfn
id=multiple0 title=attr-datagrid-multiple><code>multiple</code></dfn>
attribute, then the user must be able to select any number of rows (zero
- or more). If the attribute is not present, then the user must only be able
- to select a single row at a time, and selecting another one must unselect
- all the other rows.
+ or more). If the attribute is not present, then the user must not be able
+ to select more than a single row at a time, and selecting another one must
+ unselect all the other rows.
<p class=note>This only applies to the user. Scripts can select multiple
rows even when the <code title=attr-datagrid-multiple><a
@@ -34064,7 +34063,7 @@
It is purely advisory. The value must be a valid RFC 3066 language code.
<a href="#refsRFC3066">[RFC3066]</a> User agents must not consider this
attribute authoritative — upon fetching the resource, user agents
- must only use language information associated with the resource to
+ must use only language information associated with the resource to
determine its language, not metadata included in the link to the resource.
<p>The <dfn id=type17 title=attr-hyperlink-type><code>type</code></dfn>
@@ -37011,9 +37010,9 @@
crossing a hostile third document in the process, the hostile document
could intercept the data.
- <p>For the same reason, user agents must only consider a drop to be
- successful if the user specifically ended the drag operation — if
- any scripts end the drag operation, it must be considered unsuccessful
+ <p>For the same reason, user agents must consider a drop to be successful
+ only if the user specifically ended the drag operation — if any
+ scripts end the drag operation, it must be considered unsuccessful
(canceled) and the <code title=event-drop><a href="#drop">drop</a></code>
event must not be fired.
@@ -38314,7 +38313,7 @@
remove the URI specified in <var title="">src</var> from the <a
href="#list-of3" title=concept-event-source-list>list of event sources</a>
for that object. If the same URI has been registered multiple times,
- removing it must only remove one instance of that URI for each invocation
+ removing it must remove only one instance of that URI for each invocation
of the <code title=removeEventSource>removeEventSource()</code> method.
<p>Relative URIs must be resolved relative to <span
@@ -38361,7 +38360,7 @@
URIs for the event sources must be followed, including HTTP caching rules.
<p>For HTTP connections, the <code title="">Accept</code> header may be
- included; if included, it must only contain formats of event framing that
+ included; if included, it must contain only formats of event framing that
are supported by the user agent (one of which must be
<code>text/event-stream</code>, as described below).
@@ -51217,7 +51216,7 @@
menu was created should have appropriate pseudo-classes (:hover,
:focus, :active) applied.</p>
- <p>The menu items must only consider the computed styles of the
+ <p>The menu items must consider only the computed styles of the
elements from which they were derived, not other elements.</p>
<div class="example">
Modified: source
===================================================================
--- source 2008-05-09 07:52:23 UTC (rev 1583)
+++ source 2008-05-09 08:02:15 UTC (rev 1584)
@@ -4607,8 +4607,9 @@
the <code title="lang">lang</code> attribute represents the language
of the content.</p>
- <p>Authors must only use elements, attributes, and attribute values
- for their appropriate semantic purposes.</p>
+ <p>Authors must not use elements, attributes, and attribute values
+ for purposes other than their appropriate intended semantic
+ purpose.</p>
<div class="example">
<p>For example, the following document is non-conforming, despite
@@ -4690,8 +4691,7 @@
<p>All the elements in this specification have a defined content
model, which describes what nodes are allowed inside the elements,
and thus what the structure of an HTML document or fragment must
- look like. Authors must only put elements inside an element if that
- element allows them to be there according to its content model.</p>
+ look like.</p>
<p class="note">As noted in the conformance and terminology
sections, for the purposes of determining if an element matches its
@@ -4964,10 +4964,10 @@
model that must be satisfied.</p>
<p>When a content model includes a part that is "transparent", those
- parts must only contain content that would still be conformant if
- all transparent and semi-transparent elements in the tree were
- replaced, in their parent element, by the children in the
- "transparent" part of their content model, retaining order.</p>
+ parts must not contain content that would not be conformant if all
+ transparent and semi-transparent elements in the tree were replaced,
+ in their parent element, by the children in the "transparent" part
+ of their content model, retaining order.</p>
<p>When a transparent or semi-transparent element has no parent,
then the part of its content model that is "transparent" must
@@ -6149,9 +6149,9 @@
<p>However, if the link is an <span>external resource link</span>,
then the <code title="attr-link-media">media</code> attribute is
- prescriptive. The user agent must only apply the external resource
- to <span>views</span><!-- XXX xref --> while their state match the
- listed media.</p>
+ prescriptive. The user agent must apply the external resource to
+ <span>views</span><!-- XXX xref --> while their state match the
+ listed media, and must not apply them otherwise.</p>
<p id="default-media">The default, if the <code
title="attr-link-media">media</code> attribute is omitted, is
@@ -6937,8 +6937,8 @@
<p>The <dfn title="attr-style-media"><code>media</code></dfn>
attribute says which media the styles apply to. The value must be a
valid <a href="#mq">media query</a>. <a href="#refsMQ">[MQ]</a> User
- agents must only apply the styles to <span>views</span> while their
- state match the listed media. <a
+ agents must apply the styles to <span>views</span> while their state
+ match the listed media, and must not apply them otherwise. <a
href="#refsDOM3VIEWS">[DOM3VIEWS]</a></p>
<p id="style-default-media">The default, if the <code
@@ -6948,9 +6948,9 @@
<p>The <dfn title="attr-style-scoped"><code>scoped</code></dfn>
attribute is a <span>boolean attribute</span>. If the attribute is
- present, then the user agent must only apply the specified style
- information to the <code>style</code> element's parent element (if
- any), and that element's child nodes. Otherwise, the specified
+ present, then the user agent must apply the specified style
+ information only to the <code>style</code> element's parent element
+ (if any), and that element's child nodes. Otherwise, the specified
styles must, if applied, be applied to the entire document.</p>
<p>If the <code title="attr-style-scoped">scoped</code> attribute is
@@ -8121,7 +8121,7 @@
<code>br</code> elements must not be considered part of the
surrounding text.</p>
- <p><code>br</code> elements must only be used for line breaks that
+ <p><code>br</code> elements must be used only for line breaks that
are actually part of the content, as in poems or addresses.</p>
<div class="example">
@@ -9599,7 +9599,7 @@
<!-- XXX that means <dfn>x \n x</dfn> won't match <span>x x</span> -->
<p>If the <code title="attr-dfn-title">title</code> attribute of the
- <code>dfn</code> element is present, then it must only contain the
+ <code>dfn</code> element is present, then it must contain only the
term being defined.</p>
<p class="note">The <code title="attr-title">title</code> attribute
@@ -10642,7 +10642,7 @@
<p>The <code>sup</code> element represents a superscript and the
<code>sub</code> element represents a subscript.</p>
- <p>These elements must only be used to mark up typographical
+ <p>These elements must be used only to mark up typographical
conventions with specific meanings, not for typographical
presentation for presentation's sake. For example, it would be
inappropriate for the <code>sub</code> and <code>sup</code> elements
@@ -13534,9 +13534,9 @@
resource (within the constraints put forward by this and other
specifications); for example, reconnecting to the server in the
face of network errors, using HTTP partial range requests, or
- switching to a streaming protocol. The user agent must only
- consider a resource erroneous if it has given up trying to
- download it.</p>
+ switching to a streaming protocol. The user agent must consider a
+ resource erroneous only if it has given up trying to download
+ it.</p>
<dl class="switch">
@@ -15690,7 +15690,7 @@
</dl>
<p>These values are all case-sensitive — they must be used
- exactly as shown. User agents must only recognise values that
+ exactly as shown. User agents must not recognise values that do not
exactly match the values given above.</p>
<p>The operators in the above list must be treated as described by
@@ -15917,7 +15917,7 @@
color of the last offset, and areas outside the cone untouched by
the gradient (transparent black).</p>
- <p>Gradients must only be painted where the relevant stroking or
+ <p>Gradients must be painted only where the relevant stroking or
filling effects requires that they be drawn.</p>
<!--
@@ -15982,7 +15982,7 @@
four directions all over the canvas (if the <code>repeat</code>
string was specified). The images are not scaled by this process;
one CSS pixel of the image must be painted on one coordinate space
- unit. Of course, patterns must only actually painted where the
+ unit. Of course, patterns must actually be painted only where the
stroking or filling effect requires that they be drawn, and are
affected by the current transformation matrix.</p>
@@ -22863,8 +22863,8 @@
cell's row as the first argument, the cell's column index as the
second, and the checkbox's new state as the third. The state should
be represented by the number 1 if the new state is checked, 0 if the
- new state is unchecked, and −1 if the new state is indeterminate
- (which must only be possible if the cell has the <code
+ new state is unchecked, and −1 if the new state is
+ indeterminate (which must be possible only if the cell has the <code
title="datagrid-cell-class-indeterminate">indeterminate</code> class
set). The <code>datagrid</code> must act as if the
<code>datagrid</code>'s <code
@@ -22983,8 +22983,8 @@
title="attr-datagrid-multiple"><code>multiple</code></dfn>
attribute, then the user must be able to select any number of rows
(zero or more). If the attribute is not present, then the user must
- only be able to select a single row at a time, and selecting another
- one must unselect all the other rows.</p>
+ not be able to select more than a single row at a time, and
+ selecting another one must unselect all the other rows.</p>
<p class="note">This only applies to the user. Scripts can select
multiple rows even when the <code
@@ -31889,7 +31889,7 @@
the linked resource. It is purely advisory. The value must be a
valid RFC 3066 language code. <a href="#refsRFC3066">[RFC3066]</a>
User agents must not consider this attribute authoritative —
- upon fetching the resource, user agents must only use language
+ upon fetching the resource, user agents must use only language
information associated with the resource to determine its language,
not metadata included in the link to the resource.</p>
@@ -34677,9 +34677,9 @@
document to a second document, crossing a hostile third document in
the process, the hostile document could intercept the data.</p>
- <p>For the same reason, user agents must only consider a drop to be
- successful if the user specifically ended the drag operation —
- if any scripts end the drag operation, it must be considered
+ <p>For the same reason, user agents must consider a drop to be
+ successful only if the user specifically ended the drag operation
+ — if any scripts end the drag operation, it must be considered
unsuccessful (canceled) and the <code title="event-drop">drop</code>
event must not be fired.</p>
@@ -35855,7 +35855,7 @@
must remove the URI specified in <var title="">src</var> from the
<span title="concept-event-source-list">list of event sources</span>
for that object. If the same URI has been registered multiple
- times, removing it must only remove one instance of that URI for
+ times, removing it must remove only one instance of that URI for
each invocation of the <code
title="removeEventSource">removeEventSource()</code> method.</p>
@@ -35907,7 +35907,7 @@
caching rules.</p>
<p>For HTTP connections, the <code title="">Accept</code> header may
- be included; if included, it must only contain formats of event
+ be included; if included, it must contain only formats of event
framing that are supported by the user agent (one of which must be
<code>text/event-stream</code>, as described below).</p>
@@ -46502,7 +46502,7 @@
menu was created should have appropriate pseudo-classes (:hover,
:focus, :active) applied.</p>
- <p>The menu items must only consider the computed styles of the
+ <p>The menu items must consider only the computed styles of the
elements from which they were derived, not other elements.</p>
<div class="example">
More information about the Commit-Watchers
mailing list