NOTE: The current preferred location for bug reports is the GitHub issue tracker.
Bug 181 - 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.
Reword all conformance requirements never to use the phrase 'must only', whic...
Status: RESOLVED INTENTIONAL
Product: Validator.nu
Classification: Unclassified
Component: General
HEAD
All All
: P2 normal
Assigned To: Henri Sivonen
http://svn.whatwg.org/webapps/source?...
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2008-05-12 13:18 CEST by Nobody
Modified: 2008-07-22 17:31 CEST (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Nobody 2008-05-12 13:18:37 CEST
Index: source
===================================================================
--- source	(revision 1583)
+++ source	(revision 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 &mdash; 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 &#x2212;1 if the new state is indeterminate
-  (which must only be possible if the cell has the <code
+  new state is unchecked, and &#x2212;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 &mdash;
-  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 &mdash;
-  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
+  &mdash; 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">