- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 18 Sep 2009 21:27:17 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv7994
Modified Files:
Overview.html
Log Message:
Clarify the registries for rel='', <meta name=''>, and http-equiv=''. (whatwg r3907)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3068
retrieving revision 1.3069
diff -u -d -r1.3068 -r1.3069
--- Overview.html 18 Sep 2009 20:37:27 -0000 1.3068
+++ Overview.html 18 Sep 2009 21:27:13 -0000 1.3069
@@ -9669,11 +9669,12 @@
<dt>Brief description</dt>
- <dd><p>A short description of what the metadata name's meaning is,
- including the format the value is required to be in.</dd>
+ <dd><p>A short non-normative description of what the metadata
+ name's meaning is, including the format the value is required to be
+ in.</dd>
- <dt>Link to more details</dt>
+ <dt>Specification</dt>
<dd>A link to a more detailed description of the metadata name's
semantics and requirements. It could be another page on the Wiki,
@@ -9694,47 +9695,62 @@
<p>One of the following:</p>
- <dl><dt>Proposal</dt>
+ <dl><dt>Proposed</dt>
<dd>The name has not received wide peer review and
- approval. Someone has proposed it and is using it.</dd>
+ approval. Someone has proposed it and is, or soon will be, using
+ it.</dd>
- <dt>Accepted</dt>
+ <dt>Ratified</dt>
<dd>The name has received wide peer review and approval. It has a
specification that unambiguously defines how to handle pages that
use the name, including when they use it in incorrect ways.</dd>
- <dt>Unendorsed</dt>
+ <dt>Discontinued</dt>
<dd>The metadata name has received wide peer review and it has
- been found wanting. Existing pages are using this keyword, but
- new pages should avoid it. The "brief description" and "link to
- more details" entries will give details of what authors should
+ been found wanting. Existing pages are using this metadata name,
+ but new pages should avoid it. The "brief description" and
+ "specification" entries will give details of what authors should
use instead, if anything.</dd>
- </dl><p>If a metadata name is added with the "proposal" status and
+ </dl><p>If a metadata name is found to be redundant with existing
+ values, it should be removed and listed as a synonym for the
+ existing value.</p>
+
+ <p>If a metadata name is registered in the "proposed" state for a
+ period of a month or more without being used or specified, then it
+ may be removed from the registry.</p>
+
+ <p>If a metadata name is added with the "proposed" status and
found to be redundant with existing values, it should be removed
- and listed as a synonym for the existing value.</p>
+ and listed as a synonym for the existing value. If a metadata name
+ is added with the "proposed" status and found to be harmful, then
+ it should be changed to "discontinued" status.</p>
+
+ <p>Anyone can change the status at any time, but should only do so
+ in accordance with the definitions above.</p>
</dd>
</dl><div class="impl">
<p>Conformance checkers must use the information given on the WHATWG
- Wiki MetaExtensions page to establish if a value not explicitly
- defined in this specification is allowed or not. Conformance
- checkers may cache this information (e.g. for performance reasons or
- to avoid the use of unreliable network connectivity).</p>
+ Wiki MetaExtensions page to establish if a value is allowed or not:
+ values defined in this specification or marked as "proposed" or
+ "ratified" must be accepted, whereas values marked as "discontinued"
+ or not listed in either this specification or on the aforementioned
+ page must be rejected as invalid. Conformance checkers may cache
+ this information (e.g. for performance reasons or to avoid the use
+ of unreliable network connectivity).</p>
- <p>When an author uses a new type not defined by either this
- specification or the Wiki page, conformance checkers should offer to
- add the value to the Wiki, with the details described above, with
- the "proposal" status.</p>
+ <p>When an author uses a new metadata name not defined by either
+ this specification or the Wiki page, conformance checkers should
+ offer to add the value to the Wiki, with the details described
+ above, with the "proposed" status.</p>
- </div><p>This specification does not define how new values will get
- approved. It is expected that the Wiki will have a community that
- addresses this.<p>Metadata names whose values are to be <a href="#url" title="URL">URLs</a> must not be proposed or accepted. Links must
+ </div><p>Metadata names whose values are to be <a href="#url" title="URL">URLs</a> must not be proposed or accepted. Links must
be represented using the <code><a href="#the-link-element">link</a></code> element, not the
<code><a href="#meta">meta</a></code> element.<h5 id="pragma-directives"><span class="secno">4.2.5.3 </span>Pragma directives</h5><p>When the <dfn id="attr-meta-http-equiv" title="attr-meta-http-equiv"><code>http-equiv</code></dfn> attribute
is specified on a <code><a href="#meta">meta</a></code> element, the element is a pragma
@@ -10086,7 +10102,7 @@
PragmaExtensions page</a>. <a href="#refsWHATWGWIKI">[WHATWGWIKI]</a><p>Such extensions must use a name that is identical to a
previously-registered HTTP header defined in an RFC, and must have
behavior identical to that described for the HTTP header. Pragma
- directions corresponding to headers describing metadata, or not
+ directives corresponding to headers describing metadata, or not
requiring specific user agent processing, must not be registered;
instead, use <a href="#concept-meta-extensions" title="concept-meta-extensions">metadata
names</a>. Pragma directions corresponding to headers that affect
@@ -10096,13 +10112,15 @@
any time to add a pragma directive satisfying these conditions. Such
registrations must specify the following information:<dl><dt>Keyword</dt>
- <dd><p>The actual name being defined.</dd>
+ <dd><p>The actual name being defined. The name must match a
+ previously-registered HTTP name with the same
+ requirements.</dd>
<dt>Brief description</dt>
- <dd><p>A short description of the purpose of the pragma
- directive.</dd>
+ <dd><p>A short non-normative description of the purpose of the
+ pragma directive.</dd>
<dt>Specification</dt>
@@ -10112,10 +10130,13 @@
</dl><div class="impl">
<p>Conformance checkers must use the information given on the WHATWG
- Wiki PragmaExtensions page to establish if a value not explicitly
- defined in this specification is allowed or not. Conformance
- checkers may cache this information (e.g. for performance reasons or
- to avoid the use of unreliable network connectivity).</p>
+ Wiki PragmaExtensions page to establish if a value is allowed or
+ not: values defined in this specification or listed on the
+ aforementioned page must be accepted, whereas values not listed in
+ either this specification or on the aforementioned page must be
+ rejected as invalid. Conformance checkers may cache this information
+ (e.g. for performance reasons or to avoid the use of unreliable
+ network connectivity).</p>
</div><h5 id="charset"><span class="secno">4.2.5.5 </span>Specifying the document's character encoding</h5><!-- READ ME WHEN EDITING: if we ever move this to the "writing
HTML" section, then we have to duplicate the requirements in the
@@ -50501,10 +50522,9 @@
must also treat the keyword "<code title="">previous</code>" like
the <code title="rel-prev"><a href="#link-type-prev">prev</a></code> keyword.</p>
- </div><h5 id="other-link-types"><span class="secno">6.12.3.20 </span>Other link types</h5><p>Other than the types defined above, only types defined as
- extensions in the <a href="http://wiki.whatwg.org/wiki/RelExtensions">WHATWG Wiki
- RelExtensions page</a> may be used with the <code title="">rel</code> attribute on <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>,
- and <code><a href="#the-area-element">area</a></code> elements. <a href="#refsWHATWGWIKI">[WHATWGWIKI]</a><p>Anyone is free to edit the WHATWG Wiki RelExtensions page at any
+ </div><h5 id="other-link-types"><span class="secno">6.12.3.20 </span>Other link types</h5><p><dfn id="concept-rel-extensions" title="concept-rel-extensions">Extensions to the predefined
+ set of link types</dfn> may be registered in the <a href="http://wiki.whatwg.org/wiki/RelExtensions">WHATWG Wiki
+ RelExtensions page</a>. <a href="#refsWHATWGWIKI">[WHATWGWIKI]</a><p>Anyone is free to edit the WHATWG Wiki RelExtensions page at any
time to add a type. Extension types must be specified with the
following information:<dl><dt>Keyword</dt>
@@ -50560,10 +50580,11 @@
<dt>Brief description</dt>
- <dd><p>A short description of what the keyword's meaning is.</dd>
+ <dd><p>A short non-normative description of what the keyword's
+ meaning is.</dd>
- <dt>Link to more details</dt>
+ <dt>Specification</dt>
<dd><p>A link to a more detailed description of the keyword's
semantics and requirements. It could be another page on the Wiki,
@@ -50573,7 +50594,7 @@
<dt>Synonyms</dt>
<dd><p>A list of other keyword values that have exactly the same
- processing requirements. Authors must not use the values defined to
+ processing requirements. Authors should not use the values defined to
be synonyms, they are only intended to allow user agents to support
legacy content.</dd>
@@ -50584,53 +50605,69 @@
<p>One of the following:</p>
- <dl><dt>Proposal</dt>
+ <dl><dt>Proposed</dt>
<dd>The keyword has not received wide peer review and
- approval. It is included for completeness because pages use the
- keyword. Pages should not use the keyword.</dd>
+ approval. Someone has proposed it and is, or soon will be, using
+ it.</dd>
- <dt>Accepted</dt>
+ <dt>Ratified</dt>
<dd>The keyword has received wide peer review and approval. It
has a specification that unambiguously defines how to handle
- pages that use the keyword, including when they use them in
- incorrect ways. Pages may use the keyword.</dd>
+ pages that use the keyword, including when they use it in
+ incorrect ways.</dd>
- <dt>Rejected</dt>
+ <dt>Discontinued</dt>
<dd>The keyword has received wide peer review and it has been
- found to have significant problems. Pages must not use the
- keyword. When a keyword has this status, the "Effect
- on... <code><a href="#the-link-element">link</a></code>" and "Effect on... <code><a href="#the-a-element">a</a></code> and
- <code><a href="#the-area-element">area</a></code>" information should be set to "not
- allowed".</dd>
+ found wanting. Existing pages are using this keyword, but new
+ pages should avoid it. The "brief description" and
+ "specification" entries will give details of what authors should
+ use instead, if anything.</dd>
- </dl><p>If a keyword is added with the "proposal" status and found to
+ </dl><p>If a keyword is found to be redundant with existing values, it
+ should be removed and listed as a synonym for the existing
+ value.</p>
+
+ <p>If a keyword is registered in the "proposed" state for a
+ period of a month or more without being used or specified, then it
+ may be removed from the registry.</p>
+
+ <p>If a keyword is added with the "proposed" status and found to
be redundant with existing values, it should be removed and listed
as a synonym for the existing value. If a keyword is added with
- the "proposal" status and found to be harmful, then it should be
- changed to "rejected" status, and its "Effect on..." information
- should be changed accordingly.</p>
+ the "proposed" status and found to be harmful, then it should be
+ changed to "discontinued" status.</p>
+
+ <p>Anyone can change the status at any time, but should only do so
+ in accordance with the definitions above.</p>
</dd>
</dl><div class="impl">
<p>Conformance checkers must use the information given on the WHATWG
- Wiki RelExtensions page to establish if a value not explicitly
- defined in this specification is allowed or not. Conformance
- checkers may cache this information (e.g. for performance reasons or
- to avoid the use of unreliable network connectivity).</p>
+ Wiki RelExtensions page to establish if a value is allowed or not:
+ values defined in this specification or marked as "proposed" or
+ "ratified" must be accepted when used on the elements for which they
+ apply as described in the "Effect on..." field, whereas values
+ marked as "discontinued" or not listed in either this specification
+ or on the aforementioned page must be rejected as invalid.
+ Conformance checkers may cache this information (e.g. for
+ performance reasons or to avoid the use of unreliable network
+ connectivity).</p>
<p>When an author uses a new type not defined by either this
specification or the Wiki page, conformance checkers should offer to
add the value to the Wiki, with the details described above, with
- the "proposal" status.</p>
+ the "proposed" status.</p>
- </div><p>This specification does not define how new values will get
- approved. It is expected that the Wiki will have a community that
- addresses this.<h2 id="editing"><span class="secno">7 </span><dfn>User Interaction</dfn></h2><p>This section describes various features that allow authors to
+ </div><p>Types defined as extensions in the <a href="http://wiki.whatwg.org/wiki/RelExtensions">WHATWG Wiki
+ RelExtensions page</a> with the status "proposed" or "ratified" may
+ be used with the <code title="">rel</code> attribute on
+ <code><a href="#the-link-element">link</a></code>, <code><a href="#the-a-element">a</a></code>, and <code><a href="#the-area-element">area</a></code> elements in
+ accordance to the "Effect on..." field. <a href="#refsWHATWGWIKI">[WHATWGWIKI]</a><h2 id="editing"><span class="secno">7 </span><dfn>User Interaction</dfn></h2><p>This section describes various features that allow authors to
enable users to edit documents and parts of documents
interactively.<h3 id="the-hidden-attribute"><span class="secno">7.1 </span>The <dfn title="attr-hidden"><code>hidden</code></dfn> attribute</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>All <a href="#html-elements">HTML elements</a> may have the <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> content attribute set. The <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> attribute is a <a href="#boolean-attribute">boolean
attribute</a>. When specified on an element, it indicates that
Received on Friday, 18 September 2009 21:27:27 UTC