[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