Skip to content

Commit

Permalink
[] (0) Clarify the registries for rel='', <meta name=''>, and http-eq…
Browse files Browse the repository at this point in the history 
…uiv=''.

git-svn-id: http://svn.whatwg.org/webapps@3907 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Sep 18, 2009
1 parent 916942e commit 979495e
Show file tree
Hide file tree
Showing 2 changed files with 202 additions and 129 deletions.
164 changes: 100 additions & 64 deletions index
View file
Expand Up @@ -10912,11 +10912,12 @@ gave me some of the songs they wrote. I love sharing my music.&lt;/p&gt;

<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,
Expand All @@ -10937,57 +10938,69 @@ gave me some of the songs they wrote. I love sharing my music.&lt;/p&gt;

<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>

<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.</p>




<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
Expand Down Expand Up @@ -11355,7 +11368,7 @@ people expect to have work and what is necessary.
<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
Expand All @@ -11369,13 +11382,15 @@ people expect to have work and what is necessary.

<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>
Expand All @@ -11385,14 +11400,19 @@ people expect to have work and what is necessary.
</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
Expand Down Expand Up @@ -56134,10 +56154,9 @@ style/default.css</pre>

<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>
<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>

<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
Expand Down Expand Up @@ -56197,10 +56216,11 @@ style/default.css</pre>

<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,
Expand All @@ -56210,7 +56230,7 @@ style/default.css</pre>
<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>

Expand All @@ -56221,55 +56241,71 @@ style/default.css</pre>

<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.</p>
<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></p>



Expand Down

0 comments on commit 979495e

Please sign in to comment.