Skip to content

Commit

Permalink
Provide better encoding label guidance. (Basically require utf-8 all …
Browse files Browse the repository at this point in the history
  • Loading branch information
annevk committed Jan 21, 2013
1 parent 6277a6c commit a454d2e
Show file tree
Hide file tree
Showing 2 changed files with 16 additions and 10 deletions.
15 changes: 9 additions & 6 deletions Overview.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

<p><a class="logo" href="//www.whatwg.org/"><img alt="WHATWG" height="100" src="//resources.whatwg.org/logo-encoding.svg" width="100"></a></p>
<h1>Encoding</h1>
<h2 class="no-num no-toc" id="living-standard-—-last-updated-15-january-2013">Living Standard — Last Updated 15 January 2013</h2>
<h2 class="no-num no-toc" id="living-standard-—-last-updated-21-january-2013">Living Standard — Last Updated 21 January 2013</h2>

<dl>
<dt>This Version:
Expand Down Expand Up @@ -36,7 +36,7 @@ <h2 class="no-num no-toc" id="living-standard-—-last-updated-15-january-2013">
<p class="copyright"><a href="http://creativecommons.org/publicdomain/zero/1.0/" rel="license">CC0 1.0 Universal</a>.
To the extent possible under law, the editor has waived all copyright and
related or neighboring rights to this work. In addition, as of
15 January 2013, the editor has made this specification available
21 January 2013, the editor has made this specification available
under the
<a href="http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0" rel="license">Open Web Foundation Agreement Version 1.0</a>,
which is available at
Expand Down Expand Up @@ -219,6 +219,13 @@ <h2 id="encodings"><span class="secno">4 </span>Encodings</h2>
User agents must not support any other <a href="#encoding" title="encoding">encodings</a>
or <a href="#label" title="label">labels</a>.

<p>Authors must use the <a href="#utf-8">utf-8</a> <a href="#encoding">encoding</a> and must use the
"<code title="">utf-8</code>" <a href="#label">label</a> to identify it.

<p>New protocols and formats must use the <a href="#utf-8">utf-8</a> <a href="#encoding">encoding</a>
exclusively. If these protocols and formats need to expose the <a href="#encoding">encoding</a>'s
<a href="#label">label</a>, they must expose it as "<code title="">utf-8</code>".

<p>To <dfn id="concept-encoding-get" title="concept-encoding-get">get an encoding</dfn> from a string
<var title="">label</var>, run these steps:

Expand Down Expand Up @@ -1043,10 +1050,6 @@ <h3 id="interface-textencoder"><span class="secno">7.2 </span>Interface <code ti

<h2 id="the-encoding"><span class="secno">8 </span>The encoding</h2>

<p>New content and formats must exclusively use the <a href="#utf-8">utf-8</a>
<a href="#encoding">encoding</a>.


<h3 id="utf-8"><span class="secno">8.1 </span><dfn>utf-8</dfn></h3>

<p>The <dfn id="utf-8-code-point">utf-8 code point</dfn>, <dfn id="utf-8-bytes-seen">utf-8 bytes seen</dfn>, and
Expand Down
11 changes: 7 additions & 4 deletions Overview.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -180,6 +180,13 @@ <h2>Encodings</h2>
User agents must not support any other <span title=encoding>encodings</span>
or <span title=label>labels</span>.

<p>Authors must use the <span>utf-8</span> <span>encoding</span> and must use the
"<code title>utf-8</code>" <span>label</span> to identify it.

<p>New protocols and formats must use the <span>utf-8</span> <span>encoding</span>
exclusively. If these protocols and formats need to expose the <span>encoding</span>'s
<span>label</span>, they must expose it as "<code title>utf-8</code>".

<p>To <dfn title=concept-encoding-get>get an encoding</dfn> from a string
<var title>label</var>, run these steps:

Expand Down Expand Up @@ -1004,10 +1011,6 @@ <h3>Interface <code title>TextEncoder</code></h3>

<h2>The encoding</h2>

<p>New content and formats must exclusively use the <span>utf-8</span>
<span>encoding</span>.


<h3><dfn>utf-8</dfn></h3>

<p>The <dfn>utf-8 code point</dfn>, <dfn>utf-8 bytes seen</dfn>, and
Expand Down

0 comments on commit a454d2e

Please sign in to comment.