[html5] r3943 - [e] (0) Tighten up the definition and use of the terms 'preferred name' and 'pre [...]
whatwg at whatwg.org
whatwg at whatwg.org
Mon Sep 21 16:43:47 PDT 2009
Author: ianh
Date: 2009-09-21 16:43:46 -0700 (Mon, 21 Sep 2009)
New Revision: 3943
Modified:
index
source
Log:
[e] (0) Tighten up the definition and use of the terms 'preferred name' and 'preferred MIME name'.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7453
Modified: index
===================================================================
--- index 2009-09-21 23:36:44 UTC (rev 3942)
+++ index 2009-09-21 23:43:46 UTC (rev 3943)
@@ -1868,6 +1868,11 @@
<h4 id=character-encodings><span class=secno>2.1.6 </span>Character encodings</h4>
+ <p>The <dfn id=preferred-mime-name>preferred MIME name</dfn> of a character encoding is the
+ name or alias labeled as "preferred MIME name" in the IANA
+ <cite>Character Sets</cite> registry, if there is one, or the
+ encoding's name, if none of the aliases are so labeled. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
+
<p>An <dfn id=ascii-compatible-character-encoding>ASCII-compatible character encoding</dfn> is a
single-byte or variable-length encoding in which the bytes 0x09,
0x0A, 0x0C, 0x0D, 0x20 - 0x22, 0x26, 0x27, 0x2C - 0x3F, 0x41 - 0x5A,
@@ -6947,22 +6952,22 @@
loading affect this value, as does the <code title=dom-document-charset><a href=#dom-document-charset>charset</a></code> setter. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
<p>The <dfn id=dom-document-charset title=dom-document-charset><code>charset</code></dfn>
- IDL attribute must, on getting, return the preferred MIME name of
- the <a href="#document's-character-encoding">document's character encoding</a>. On setting, if the
- new value is an IANA-registered alias for a character encoding
- supported by the user agent, the <a href="#document's-character-encoding">document's character
- encoding</a> must be set to that character encoding. (Otherwise,
- nothing happens.)</p>
+ IDL attribute must, on getting, return the <a href=#preferred-mime-name>preferred MIME
+ name</a> of the <a href="#document's-character-encoding">document's character encoding</a>. On
+ setting, if the new value is an IANA-registered alias for a
+ character encoding supported by the user agent, the <a href="#document's-character-encoding">document's
+ character encoding</a> must be set to that character
+ encoding. (Otherwise, nothing happens.)</p>
<p>The <dfn id=dom-document-characterset title=dom-document-characterSet><code>characterSet</code></dfn>
- IDL attribute must, on getting, return the preferred MIME name of
- the <a href="#document's-character-encoding">document's character encoding</a>.</p>
+ IDL attribute must, on getting, return the <a href=#preferred-mime-name>preferred MIME
+ name</a> of the <a href="#document's-character-encoding">document's character encoding</a>.</p>
<p>The <dfn id=dom-document-defaultcharset title=dom-document-defaultCharset><code>defaultCharset</code></dfn>
- IDL attribute must, on getting, return the preferred MIME name of a
- character encoding, possibly the user's default encoding, or an
- encoding associated with the user's current geographical location,
- or any arbitrary encoding name.</p>
+ IDL attribute must, on getting, return the <a href=#preferred-mime-name>preferred MIME
+ name</a> of a character encoding, possibly the user's default
+ encoding, or an encoding associated with the user's current
+ geographical location, or any arbitrary encoding name.</p>
<hr></div>
@@ -11466,7 +11471,7 @@
character encoding used to serialize the file.</li>
<li>The value must be a valid character encoding name, and must be
- the preferred name for that encoding. <a href=#refsIANACHARSET>[IANACHARSET]</a></li>
+ the <a href=#preferred-mime-name>preferred MIME name</a> for that encoding. <a href=#refsIANACHARSET>[IANACHARSET]</a></li>
<li>The character encoding declaration must be serialized without
the use of <a href=#syntax-charref title=syntax-charref>character references</a>
@@ -11929,10 +11934,10 @@
attribute gives the character encoding of the external script
resource. The attribute must not be specified if the <code title=attr-script-src><a href=#attr-script-src>src</a></code> attribute is not present. If the
attribute is set, its value must be a valid character encoding name,
- must be the preferred name for that encoding, and must match the
- encoding given in the <code title="">charset</code> parameter of the
- <a href=#content-type title=Content-Type>Content-Type metadata</a> of the
- external file, if any. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
+ must be the <a href=#preferred-mime-name>preferred MIME name</a> for that encoding, and
+ must match the encoding given in the <code title="">charset</code>
+ parameter of the <a href=#content-type title=Content-Type>Content-Type
+ metadata</a> of the external file, if any. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
<p>The <dfn id=attr-script-async title=attr-script-async><code>async</code></dfn> and
<dfn id=attr-script-defer title=attr-script-defer><code>defer</code></dfn> attributes
@@ -30298,8 +30303,8 @@
attribute gives the character encodings that are to be used for the
submission. If specified, the value must be an <a href=#ordered-set-of-unique-space-separated-tokens>ordered set of
unique space-separated tokens</a>, and each token must be the
- preferred name of an <a href=#ascii-compatible-character-encoding>ASCII-compatible character
- encoding</a>. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
+ <a href=#preferred-mime-name>preferred MIME name</a> of an <a href=#ascii-compatible-character-encoding>ASCII-compatible
+ character encoding</a>. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
<p>The <dfn id=attr-form-name title=attr-form-name><code>name</code></dfn> attribute
represents the <code><a href=#the-form-element>form</a></code>'s name within the <code title=dom-document-forms><a href=#dom-document-forms>forms</a></code> collection. The value must
@@ -38958,8 +38963,8 @@
</li>
- <li><p>Let <var title="">charset</var> be the preferred MIME name
- of the selected character encoding.</li>
+ <li><p>Let <var title="">charset</var> be the <a href=#preferred-mime-name>preferred MIME
+ name</a> of the selected character encoding.</li>
<li><p>If the entry's name is "<code title="">_charset_</code>" and
its type is "<code title="">hidden</code>", replace its value with
@@ -39079,8 +39084,8 @@
</li>
- <li><p>Let <var title="">charset</var> be the preferred MIME name
- of the selected character encoding.</li>
+ <li><p>Let <var title="">charset</var> be the <a href=#preferred-mime-name>preferred MIME
+ name</a> of the selected character encoding.</li>
<li><p>If the entry's name is "<code title="">_charset_</code>" and
its type is "<code title="">hidden</code>", replace its value with
@@ -62293,10 +62298,10 @@
<p class=note>It is not unusual for Web browsers to support dozens
if not upwards of a hundred distinct character encodings.</p>
- <p>User agents must support the preferred MIME name of every
- character encoding they support that has a preferred MIME name, and
- should support all the IANA-registered aliases of every character
- encoding they support. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
+ <p>User agents must support the <a href=#preferred-mime-name>preferred MIME name</a> of
+ every character encoding they support, and should support all the
+ IANA-registered names and aliases of every character encoding they
+ support. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
<p>When comparing a string specifying a character encoding with the
name or alias of a character encoding to determine if they are
@@ -74996,8 +75001,8 @@
declaration">character encoding declarations</a> in the
document. The parameter's value must be the name of the
character encoding used to serialize the file, must be a valid
- character encoding name, and must be the preferred name for that
- encoding. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
+ character encoding name, and must be the <a href=#preferred-mime-name>preferred MIME
+ name</a> for that encoding. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
</dd>
</dl></dd>
<dt>Encoding considerations:</dt>
Modified: source
===================================================================
--- source 2009-09-21 23:36:44 UTC (rev 3942)
+++ source 2009-09-21 23:43:46 UTC (rev 3943)
@@ -874,6 +874,12 @@
<h4>Character encodings</h4>
+ <p>The <dfn>preferred MIME name</dfn> of a character encoding is the
+ name or alias labeled as "preferred MIME name" in the IANA
+ <cite>Character Sets</cite> registry, if there is one, or the
+ encoding's name, if none of the aliases are so labeled. <a
+ href="#refsIANACHARSET">[IANACHARSET]</a></p>
+
<p>An <dfn>ASCII-compatible character encoding</dfn> is a
single-byte or variable-length encoding in which the bytes 0x09,
0x0A, 0x0C, 0x0D, 0x20 - 0x22, 0x26, 0x27, 0x2C - 0x3F, 0x41 - 0x5A,
@@ -6907,24 +6913,24 @@
href="#refsIANACHARSET">[IANACHARSET]</a></p>
<p>The <dfn title="dom-document-charset"><code>charset</code></dfn>
- IDL attribute must, on getting, return the preferred MIME name of
- the <span>document's character encoding</span>. On setting, if the
- new value is an IANA-registered alias for a character encoding
- supported by the user agent, the <span>document's character
- encoding</span> must be set to that character encoding. (Otherwise,
- nothing happens.)</p>
+ IDL attribute must, on getting, return the <span>preferred MIME
+ name</span> of the <span>document's character encoding</span>. On
+ setting, if the new value is an IANA-registered alias for a
+ character encoding supported by the user agent, the <span>document's
+ character encoding</span> must be set to that character
+ encoding. (Otherwise, nothing happens.)</p>
<p>The <dfn
title="dom-document-characterSet"><code>characterSet</code></dfn>
- IDL attribute must, on getting, return the preferred MIME name of
- the <span>document's character encoding</span>.</p>
+ IDL attribute must, on getting, return the <span>preferred MIME
+ name</span> of the <span>document's character encoding</span>.</p>
<p>The <dfn
title="dom-document-defaultCharset"><code>defaultCharset</code></dfn>
- IDL attribute must, on getting, return the preferred MIME name of a
- character encoding, possibly the user's default encoding, or an
- encoding associated with the user's current geographical location,
- or any arbitrary encoding name.</p>
+ IDL attribute must, on getting, return the <span>preferred MIME
+ name</span> of a character encoding, possibly the user's default
+ encoding, or an encoding associated with the user's current
+ geographical location, or any arbitrary encoding name.</p>
<hr>
@@ -12075,7 +12081,7 @@
character encoding used to serialize the file.</li>
<li>The value must be a valid character encoding name, and must be
- the preferred name for that encoding. <a
+ the <span>preferred MIME name</span> for that encoding. <a
href="#refsIANACHARSET">[IANACHARSET]</a></li>
<li>The character encoding declaration must be serialized without
@@ -12592,10 +12598,10 @@
resource. The attribute must not be specified if the <code
title="attr-script-src">src</code> attribute is not present. If the
attribute is set, its value must be a valid character encoding name,
- must be the preferred name for that encoding, and must match the
- encoding given in the <code title="">charset</code> parameter of the
- <span title="Content-Type">Content-Type metadata</span> of the
- external file, if any. <a
+ must be the <span>preferred MIME name</span> for that encoding, and
+ must match the encoding given in the <code title="">charset</code>
+ parameter of the <span title="Content-Type">Content-Type
+ metadata</span> of the external file, if any. <a
href="#refsIANACHARSET">[IANACHARSET]</a></p>
<p>The <dfn title="attr-script-async"><code>async</code></dfn> and
@@ -33594,8 +33600,9 @@
attribute gives the character encodings that are to be used for the
submission. If specified, the value must be an <span>ordered set of
unique space-separated tokens</span>, and each token must be the
- preferred name of an <span>ASCII-compatible character
- encoding</span>. <a href="#refsIANACHARSET">[IANACHARSET]</a></p>
+ <span>preferred MIME name</span> of an <span>ASCII-compatible
+ character encoding</span>. <a
+ href="#refsIANACHARSET">[IANACHARSET]</a></p>
<p>The <dfn title="attr-form-name"><code>name</code></dfn> attribute
represents the <code>form</code>'s name within the <code
@@ -43698,8 +43705,8 @@
</li>
- <li><p>Let <var title="">charset</var> be the preferred MIME name
- of the selected character encoding.</p></li>
+ <li><p>Let <var title="">charset</var> be the <span>preferred MIME
+ name</span> of the selected character encoding.</p></li>
<li><p>If the entry's name is "<code title="">_charset_</code>" and
its type is "<code title="">hidden</code>", replace its value with
@@ -43840,8 +43847,8 @@
</li>
- <li><p>Let <var title="">charset</var> be the preferred MIME name
- of the selected character encoding.</p></li>
+ <li><p>Let <var title="">charset</var> be the <span>preferred MIME
+ name</span> of the selected character encoding.</p></li>
<li><p>If the entry's name is "<code title="">_charset_</code>" and
its type is "<code title="">hidden</code>", replace its value with
@@ -76948,11 +76955,10 @@
<p class="note">It is not unusual for Web browsers to support dozens
if not upwards of a hundred distinct character encodings.</p>
- <p>User agents must support the preferred MIME name of every
- character encoding they support that has a preferred MIME name, and
- should support all the IANA-registered aliases of every character
- encoding they support. <a
- href="#refsIANACHARSET">[IANACHARSET]</a></p>
+ <p>User agents must support the <span>preferred MIME name</span> of
+ every character encoding they support, and should support all the
+ IANA-registered names and aliases of every character encoding they
+ support. <a href="#refsIANACHARSET">[IANACHARSET]</a></p>
<p>When comparing a string specifying a character encoding with the
name or alias of a character encoding to determine if they are
@@ -88997,8 +89003,9 @@
declaration">character encoding declarations</span> in the
document. The parameter's value must be the name of the
character encoding used to serialize the file, must be a valid
- character encoding name, and must be the preferred name for that
- encoding. <a href="#refsIANACHARSET">[IANACHARSET]</a></p>
+ character encoding name, and must be the <span>preferred MIME
+ name</span> for that encoding. <a
+ href="#refsIANACHARSET">[IANACHARSET]</a></p>
</dd>
</dl>
</dd>
More information about the Commit-Watchers
mailing list