- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sun, 27 Sep 2009 09:09:23 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv11536
Modified Files:
Overview.html
Log Message:
Change 'unless' to 'except where' in cases where that reduces ambiguity. (whatwg r4006)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3167
retrieving revision 1.3168
diff -u -d -r1.3167 -r1.3168
--- Overview.html 27 Sep 2009 01:53:14 -0000 1.3167
+++ Overview.html 27 Sep 2009 09:09:20 -0000 1.3168
@@ -1621,8 +1621,8 @@
the purposes of the DOM and CSS. The term "<dfn id="html-elements">HTML
elements</dfn>", when used in this specification, refers to any
element in that namespace, and thus refers to both HTML and XHTML
- elements.<p>Unless otherwise stated, all elements defined or mentioned in
- this specification are in the
+ elements.<p>Except where otherwise stated, all elements defined or mentioned
+ in this specification are in the
<code>http://www.w3.org/1999/xhtml</code> namespace, and all
attributes defined or mentioned in this specification have no
namespace.<p>Attribute names are said to be <dfn id="xml-compatible">XML-compatible</dfn> if they
@@ -2016,14 +2016,14 @@
required for conforming IDL fragments, as described in the Web IDL
specification. <a href="#refsWEBIDL">[WEBIDL]</a></p>
- <p id="float-nan">Unless otherwise specified, if an IDL attribute
- that is a floating point number type (<code title="">float</code>)
- is assigned an Infinity or Not-a-Number (NaN) value, a
- <code><a href="#not_supported_err">NOT_SUPPORTED_ERR</a></code> exception must be raised.</p>
+ <p id="float-nan">Except where otherwise specified, if an IDL
+ attribute that is a floating point number type (<code title="">float</code>) is assigned an Infinity or Not-a-Number
+ (NaN) value, a <code><a href="#not_supported_err">NOT_SUPPORTED_ERR</a></code> exception must be
+ raised.</p>
- <p>Unless otherwise specified, if a method with an argument that
- is a floating point number type (<code title="">float</code>) is
- passed an Infinity or Not-a-Number (NaN) value, a
+ <p>Except where otherwise specified, if a method with an argument
+ that is a floating point number type (<code title="">float</code>)
+ is passed an Infinity or Not-a-Number (NaN) value, a
<code><a href="#not_supported_err">NOT_SUPPORTED_ERR</a></code> exception must be raised.</p>
</dd>
@@ -6902,9 +6902,9 @@
<li><code title="attr-style"><a href="#the-style-attribute">style</a></code></li>
<li><code title="attr-tabindex"><a href="#attr-tabindex">tabindex</a></code></li>
<li><code title="attr-title"><a href="#the-title-attribute">title</a></code></li>
- </ul><hr><p>Unless otherwise specified, the following <a href="#event-handler-content-attributes">event handler
- content attributes</a> may be specified on any <a href="#html-elements" title="HTML
- elements">HTML element</a>:<ul class="brief"><li><code title="handler-onabort"><a href="#handler-onabort">onabort</a></code></li>
+ </ul><hr><p>The following <a href="#event-handler-content-attributes">event handler content attributes</a> may
+ be specified on any <a href="#html-elements" title="HTML elements">HTML
+ element</a>:<ul class="brief"><li><code title="handler-onabort"><a href="#handler-onabort">onabort</a></code></li>
<li><code title="handler-onblur"><a href="#handler-onblur">onblur</a></code>*</li>
<li><code title="handler-oncanplay"><a href="#handler-oncanplay">oncanplay</a></code></li>
<li><code title="handler-oncanplaythrough"><a href="#handler-oncanplaythrough">oncanplaythrough</a></code></li>
@@ -18892,9 +18892,9 @@
resource</dfn> is used to refer to the complete set of media data,
e.g. the complete video file, or complete audio file.<div class="impl">
- <p>Unless otherwise specified, the <a href="#task-source">task source</a> for all
- the tasks <a href="#queue-a-task" title="queue a task">queued</a> in this section
- and its subsections is the <dfn id="media-element-event-task-source">media element event task
+ <p>Except where otherwise specified, the <a href="#task-source">task source</a>
+ for all the tasks <a href="#queue-a-task" title="queue a task">queued</a> in this
+ section and its subsections is the <dfn id="media-element-event-task-source">media element event task
source</dfn>.</p>
</div><h5 id="error-codes"><span class="secno">4.8.10.1 </span>Error codes</h5><dl class="domintro"><dt><var title="">media</var> . <code title="dom-media-error"><a href="#dom-media-error">error</a></code></dt>
@@ -21560,9 +21560,9 @@
attribute must return the <code><a href="#the-canvas-element">canvas</a></code> element that the
context paints on.</p>
- <p>Unless otherwise stated, for the 2D context interface, any method
- call with a numeric argument whose value is infinite or a NaN value
- must be ignored.</p>
+ <p>Except where otherwise specified, for the 2D context interface,
+ any method call with a numeric argument whose value is infinite or a
+ NaN value must be ignored.</p>
<!--
Philip Taylor wrote:
@@ -27440,7 +27440,7 @@
element's <dfn id="labeled-control">labeled control</dfn></span>, either using <code title="attr-label-for"><a href="#attr-label-for">for</a></code> attribute, or by putting the form
control inside the <code><a href="#the-label-element">label</a></code> element itself.<div class="impl">
- <p>Unless otherwise specified by the following rules, a
+ <p>Except where otherwise specified by the following rules, a
<code><a href="#the-label-element">label</a></code> element has no <a href="#labeled-control">labeled control</a>.</p>
</div><p>The <dfn id="attr-label-for" title="attr-label-for"><code>for</code></dfn> attribute
@@ -28757,10 +28757,11 @@
<a href="#value-sanitization-algorithm">value sanitization algorithm</a>, if the <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute's current state
defines one.</p>
- <p>Each <code><a href="#the-input-element">input</a></code> element is either <dfn id="concept-input-mutable" title="concept-input-mutable"><i>mutable</i></dfn> or <dfn id="concept-input-immutable" title="concept-input-immutable"><i>immutable</i></dfn>. Unless
- otherwise specified, an <code><a href="#the-input-element">input</a></code> element is always <i title="concept-input-mutable"><a href="#concept-input-mutable">mutable</a></i>. Unless otherwise
- specified, the user agent should not allow the user to modify the
- element's <a href="#concept-fe-value" title="concept-fe-value">value</a> or <a href="#concept-fe-checked" title="concept-fe-checked">checkedness</a>.</p>
+ <p>Each <code><a href="#the-input-element">input</a></code> element is either <dfn id="concept-input-mutable" title="concept-input-mutable"><i>mutable</i></dfn> or <dfn id="concept-input-immutable" title="concept-input-immutable"><i>immutable</i></dfn>. Except where
+ otherwise specified, an <code><a href="#the-input-element">input</a></code> element is always <i title="concept-input-mutable"><a href="#concept-input-mutable">mutable</a></i>. Similarly, except where
+ otherwise specified, the user agent should not allow the user to
+ modify the element's <a href="#concept-fe-value" title="concept-fe-value">value</a> or
+ <a href="#concept-fe-checked" title="concept-fe-checked">checkedness</a>.</p>
<p>When an <code><a href="#the-input-element">input</a></code> element is <a href="#concept-fe-disabled" title="concept-fe-disabled">disabled</a>, it is <i title="concept-input-immutable"><a href="#concept-input-immutable">immutable</a></i>.</p>
@@ -32612,8 +32613,8 @@
of an <code><a href="#the-option-element">option</a></code> element is a boolean state, initially
false. If the element is <a href="#concept-option-disabled" title="concept-option-disabled">disabled</a>, then the element's
<a href="#concept-option-selectedness" title="concept-option-selectedness">selectedness</a> is
- always false and cannot be set to true. Unless otherwise specified,
- when the element is created, its <a href="#concept-option-selectedness" title="concept-option-selectedness">selectedness</a> must be set
+ always false and cannot be set to true. Except where otherwise
+ specified, when the element is created, its <a href="#concept-option-selectedness" title="concept-option-selectedness">selectedness</a> must be set
to true if the element has a <code title="attr-option-selected"><a href="#attr-option-selected">selected</a></code> attribute. Whenever an
<code><a href="#the-option-element">option</a></code> element's <code title="attr-option-selected"><a href="#attr-option-selected">selected</a></code> attribute is added, its
<a href="#concept-option-selectedness" title="concept-option-selectedness">selectedness</a> must
@@ -33738,7 +33739,7 @@
<p>A <a href="#category-listed" title="category-listed">listed form-associated
element</a> is a <dfn id="candidate-for-constraint-validation">candidate for constraint validation</dfn>
- unless a condition has <dfn id="barred-from-constraint-validation" title="barred from constraint
+ except when a condition has <dfn id="barred-from-constraint-validation" title="barred from constraint
validation">barred the element from constraint
validation</dfn>. (For example, an element is <a href="#barred-from-constraint-validation">barred from
constraint validation</a> if it is an <code><a href="#the-output-element">output</a></code> or
@@ -39771,9 +39772,9 @@
<code title="md-vcard-n-honorific-suffix"><a href="#md-vcard-n-honorific-suffix">honorific-suffix</a></code>
properties.</p>
- <p>Unless one of the conditions given below applies, exactly one
- property with the name <code title="md-vcard-n"><a href="#md-vcard-n">n</a></code> must be
- present within each <a href="#concept-item" title="concept-item">item</a> with
+ <p>Except when one of the conditions given below applies, exactly
+ one property with the name <code title="md-vcard-n"><a href="#md-vcard-n">n</a></code> must
+ be present within each <a href="#concept-item" title="concept-item">item</a> with
the type <code title="md-vcard"><a href="#md-vcard">vcard</a></code>.</p>
<p>If one of the following conditions does apply, then the <code title="md-vcard-n"><a href="#md-vcard-n">n</a></code> may be omitted:</p>
@@ -41588,9 +41589,9 @@
<h3 id="converting-html-to-other-formats"><span class="secno">5.5 </span>Converting HTML to other formats</h3>
- <p>In all these algorithms, unless otherwise stated, operations that
- iterate over a series of elements (whether items, properties, or
- otherwise) must do so in <a href="#tree-order">tree order</a>.</p>
+ <p>In all these algorithms, except where otherwise stated,
+ operations that iterate over a series of elements (whether items,
+ properties, or otherwise) must do so in <a href="#tree-order">tree order</a>.</p>
<p>A generic API upon which the vocabulary-specific conversions
defined below (vCard, iCalendar) can be built will need to provide
@@ -43054,7 +43055,7 @@
</div><h2 id="browsers"><span class="secno">6 </span>Web browsers</h2><div class="impl">
<p>This section describes features that apply most directly to Web
- browsers. Having said that, unless specified elsewhere, the
+ browsers. Having said that, except where specified otherwise, the
requirements defined in this section <em>do</em> apply to all user
agents, whether they are Web browsers or not.</p>
@@ -43119,9 +43120,9 @@
data mining tools are likely to never instantiate browsing
contexts.<hr><p>A <a href="#browsing-context">browsing context</a> can have a <dfn id="creator-browsing-context">creator browsing
context</dfn>, the <a href="#browsing-context">browsing context</a> that was
- responsible for its creation. <span class="impl">Unless otherwise
- specified, a <a href="#browsing-context">browsing context</a> has no <a href="#creator-browsing-context">creator
- browsing context</a>.</span><p>If a <a href="#browsing-context">browsing context</a> <var title="">A</var> has a
+ responsible for its creation. <span class="impl">Except when
+ otherwise specified, a <a href="#browsing-context">browsing context</a> has no
+ <a href="#creator-browsing-context">creator browsing context</a>.</span><p>If a <a href="#browsing-context">browsing context</a> <var title="">A</var> has a
<a href="#creator-browsing-context">creator browsing context</a>, then the
<code>Document</code> that was the <a href="#active-document">active document</a> of
that <a href="#creator-browsing-context">creator browsing context</a> at the time <var title="">A</var> was created is the <dfn id="creator-document">creator
@@ -43981,8 +43982,8 @@
<code>Document</code> object in a <a href="#browsing-context">browsing
context</a>. Some of the user interface elements represented by
these objects might have no equivalent in some user agents; for
- those user agents, unless otherwise specified, the object must act
- as if it was present and visible (i.e. its <code title="dom-BarProp-visible"><a href="#dom-barprop-visible">visible</a></code> attribute must return
+ those user agents, except when otherwise specified, the object must
+ act as if it was present and visible (i.e. its <code title="dom-BarProp-visible"><a href="#dom-barprop-visible">visible</a></code> attribute must return
true).</p>
<dl><dt><dfn id="the-location-bar-barprop-object">The location bar <code>BarProp</code> object</dfn></dt>
@@ -44234,9 +44235,8 @@
<dt>If a <code>Document</code> or image was returned by the
<code>XMLHttpRequest</code> API</dt>
- <dd>The <a href="#origin">origin</a> and <a href="#effective-script-origin">effective script
- origin</a> are equal to the <span>XMLHttpRequest origin</span>
- of the <code>XMLHttpRequest</code> object. <a href="#refsXHR">[XHR]</a></dd>
+ <dd>The <a href="#origin">origin</a> is equal to the <span>XMLHttpRequest
+ origin</span> of the <code>XMLHttpRequest</code> object. <a href="#refsXHR">[XHR]</a></dd>
<dt>If a <code>Document</code> or image was generated from a
@@ -44291,10 +44291,9 @@
<dd>The <a href="#origin">origin</a> is a globally unique identifier
assigned when the <code>Document</code> or image is created.</dd>
- </dl><p>When a <code>Document</code> is created, unless stated
- otherwise above, its <a href="#effective-script-origin">effective script origin</a> is
- initialized to the <a href="#origin">origin</a> of the
- <code>Document</code>. However, the <code title="dom-document-domain"><a href="#dom-document-domain">document.domain</a></code> attribute can
+ </dl><p>When a <code>Document</code> is created, its <a href="#effective-script-origin">effective
+ script origin</a> is initialized to the <a href="#origin">origin</a> of
+ the <code>Document</code>. However, the <code title="dom-document-domain"><a href="#dom-document-domain">document.domain</a></code> attribute can
be used to change it.</p>
</dd>
@@ -45156,9 +45155,9 @@
</div><!--test: <a href="http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%0A...%3Cscript%3E%0Aw(a%3Ddocument.implementation.createDocument(null%2C%20null%2C%20null))%3B%0Aw(a.appendChild(a.createElementNS('http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml'%2C%20'html')))%3B%0Aw(b%3Da.firstChild.appendChild(a.createElementNS('http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml'%2C%20'body')))%3B%0Aw(b.test%20%3D%20w)%3B%0Aw(b.setAttribute('onclick'%2C%20'test(%22fire%3A%20%22%20%2B%20event)'))%3B%0Aw(b.onclick)%3B%0Aw(e%3Da.createEvent('Event'))%3B%0Aw(e.initEvent('click'%2C%20false%2C%20false))%3B%0Aw(b.dispatchEvent(e))%3B%0A%3C%2Fscript%3E">test</a>--><p>Many objects can have <dfn id="event-handler-attributes-0">event handler attributes</dfn>
specified. These act as bubbling event listeners for the object on
which they are specified.<p>An <a href="#event-handler-attributes-0" title="event handler attributes">event handler
- attribute</a>, unless otherwise specified, can either have the
- value null or be set to a <code><a href="#function">Function</a></code> object. <span class="impl">Initially, an event handler attribute must be set to
- null.</span><p>Event handler attributes are exposed in one or two ways.<p>The first way, common to all event handler attributes, is as an
+ attribute</a> can either have the value null or be set to a
+ <code><a href="#function">Function</a></code> object. <span class="impl">Initially, event
+ handler attributes must be set to null.</span><p>Event handler attributes are exposed in one or two ways.<p>The first way, common to all event handler attributes, is as an
<a href="#event-handler-idl-attributes" title="event handler IDL attributes">event handler IDL
attribute</a>.<p>The second way is as an <a href="#event-handler-content-attributes" title="event handler content
attributes">event handler content attribute</a>. Event handlers on
@@ -45446,21 +45445,22 @@
the time the event is created.</p>
<p><dfn id="fire-a-simple-event" title="fire a simple event">Firing a simple event called
- <var title="">e</var></dfn> means that an event with the name <var title="">e</var>, with no namespace, which does not bubble (unless
- otherwise stated) and is not cancelable (unless otherwise stated),
- and which uses the <code>Event</code> interface, must be dispatched
- at the given target.</p>
+ <var title="">e</var></dfn> means that an event with the name <var title="">e</var>, with no namespace, which does not bubble (except
+ where otherwise stated) and is not cancelable (except where
+ otherwise stated), and which uses the <code>Event</code> interface,
+ must be dispatched at the given target.</p>
<p><dfn id="fire-a-progress-event" title="fire a progress event">Firing a progress event called
<var title="">e</var></dfn>, optionally in the context of a
particular instance of the <a href="#fetch" title="fetch">fetching
- algorithm</a>, means that an event with the name <var title="">e</var>, with no namespace, which does not bubble (unless
- otherwise stated) and is not cancelable (unless otherwise stated),
- and which uses the <code>ProgressEvent</code> interface, must be
- dispatched at the given target element. If there is a <a href="#fetch" title="fetch">fetching algorithm</a>, and the <a href="#url">URL</a>
- being <a href="#fetch" title="fetch">fetched</a> has the <a href="#same-origin">same
- origin</a> as the <code>Document</code> of the target element,
- then the <code title="dom-ProgressEvents-lengthComputable">lengthComputable</code>
+ algorithm</a>, means that an event with the name <var title="">e</var>, with no namespace, which does not bubble (except
+ where otherwise stated) and is not cancelable (except where
+ otherwise stated), and which uses the <code>ProgressEvent</code>
+ interface, must be dispatched at the given target element. If there
+ is a <a href="#fetch" title="fetch">fetching algorithm</a>, and the
+ <a href="#url">URL</a> being <a href="#fetch" title="fetch">fetched</a> has the
+ <a href="#same-origin">same origin</a> as the <code>Document</code> of the target
+ element, then the <code title="dom-ProgressEvents-lengthComputable">lengthComputable</code>
attribute must be set to true if the <a href="#fetch" title="fetch">fetching
algorithm</a>'s subject has a known <a href="#concept-fetch-total" title="concept-fetch-total">size</a>; the <code title="dom-ProgressEvents-total">total</code> attribute must be set
to the subject's <a href="#concept-fetch-total" title="concept-fetch-total">size</a> if it
@@ -45471,7 +45471,7 @@
attribute must be set to false, and the <code title="dom-ProgressEvents-total">total</code> and the <code title="dom-ProgressEvents-loaded">loaded</code> attributes must be
set to zero. <a href="#refsPROGRESS">[PROGRESS]</a></p>
- <p>The default action of these event is to do nothing unless
+ <p>The default action of these event is to do nothing where where
otherwise stated.</p>
</div><div class="impl">
@@ -50125,8 +50125,8 @@
spaces">split on spaces</a>. The resulting tokens are the link
types that apply to that element.</p>
- </div><p>Unless otherwise specified, a keyword must not be specified more
- than once per <code title="attr-rel-hyperlink">rel</code>
+ </div><p>Except where otherwise specified, a keyword must not be specified
+ more than once per <code title="attr-rel-hyperlink">rel</code>
attribute.<p>The link types are <a href="#ascii-case-insensitive">ASCII case-insensitive</a>
values<span class="impl">, and must be compared as such</span>.<p class="example">Thus, <code title="">rel="next"</code> is the
same as <code title="">rel="NEXT"</code>.<table><thead><tr><th rowspan="2">Link type</th>
@@ -53923,7 +53923,7 @@
<p>There are three variants to this method, with one, two, and three
arguments respectively. The <var title="">showUI</var> and <var title="">value</var> parameters, even if specified, are ignored
- unless otherwise stated.</p>
+ except where otherwise stated.</p>
<p>When <code title="dom-document-execCommand"><a href="#execCommand">execCommand()</a></code>
is invoked, the user agent must follow the following steps:</p>
@@ -54392,13 +54392,13 @@
<a href="#channel-messaging">channel messaging</a> the <code><a href="#messageportarray">MessagePortArray</a></code>
being sent, if any.</p>
- <p>Unless otherwise specified, when the user agent creates and
+ <p>Except where otherwise specified, when the user agent creates and
dispatches a <code title="event-message"><a href="#event-message">message</a></code> event in the
algorithms described in the following sections, the <code title="dom-MessageEvent-lastEventId"><a href="#dom-messageevent-lasteventid">lastEventId</a></code> attribute
must be the empty string, the <code title="dom-MessageEvent-origin"><a href="#dom-messageevent-origin">origin</a></code> attribute must be the
empty string, the <code title="dom-MessageEvent-source"><a href="#dom-messageevent-source">source</a></code> attribute must be
- null, and the <code title="dom-MessageEvent-ports"><a href="#dom-messageevent-ports">ports</a></code> attribute
- must be null.</p>
+ null, and the <code title="dom-MessageEvent-ports"><a href="#dom-messageevent-ports">ports</a></code>
+ attribute must be null.</p>
</div><h3 id="crossDocumentMessages"><span class="secno">8.2 </span><dfn>Cross-document messaging</dfn></h3><p class="XXX annotation"><b>Status: </b><i>Awaiting implementation feedback</i><p>Web browsers, for security and privacy reasons, prevent documents
in different domains from affecting each other; that is, cross-site
@@ -65008,9 +65008,9 @@
<h4 id="introduction-7"><span class="secno">11.2.1 </span>Introduction</h4>
- <p>The CSS rules given in these subsections are, unless otherwise
- specified, expected to be used as part of the user-agent level style
- sheet defaults for all documents that contain <a href="#html-elements">HTML
+ <p>The CSS rules given in these subsections are, except where
+ otherwise specified, expected to be used as part of the user-agent
+ level style sheet defaults for all documents that contain <a href="#html-elements">HTML
elements</a>.</p>
<p>Some rules are intended for the author-level zero-specificity
Received on Sunday, 27 September 2009 09:09:34 UTC