[html5] r2548 - [] (0) Define how to register new http-equiv values. (credit: ma)
whatwg at whatwg.org
whatwg at whatwg.org
Sat Dec 20 01:44:56 PST 2008
Author: ianh
Date: 2008-12-20 01:44:56 -0800 (Sat, 20 Dec 2008)
New Revision: 2548
Modified:
index
source
Log:
[] (0) Define how to register new http-equiv values. (credit: ma)
Modified: index
===================================================================
--- index 2008-12-20 09:21:43 UTC (rev 2547)
+++ index 2008-12-20 09:44:56 UTC (rev 2548)
@@ -337,7 +337,8 @@
<li><a href=#standard-metadata-names><span class=secno>4.2.5.1 </span>Standard metadata names</a></li>
<li><a href=#other-metadata-names><span class=secno>4.2.5.2 </span>Other metadata names</a></li>
<li><a href=#pragma-directives><span class=secno>4.2.5.3 </span>Pragma directives</a></li>
- <li><a href=#charset><span class=secno>4.2.5.4 </span>Specifying the document's character encoding</a></ol></li>
+ <li><a href=#other-pragma-directives><span class=secno>4.2.5.4 </span>Other pragma directives</a></li>
+ <li><a href=#charset><span class=secno>4.2.5.5 </span>Specifying the document's character encoding</a></ol></li>
<li><a href=#the-style-element><span class=secno>4.2.6 </span>The <code>style</code> element</a></li>
<li><a href=#styling><span class=secno>4.2.7 </span>Styling</a></ol></li>
<li><a href=#scripting-1><span class=secno>4.3 </span>Scripting</a>
@@ -9099,8 +9100,50 @@
any particular state in the document at a time.</p>
- <h5 id=charset><span class=secno>4.2.5.4 </span>Specifying the document's character encoding</h5>
+ <h5 id=other-pragma-directives><span class=secno>4.2.5.4 </span>Other pragma directives</h5>
+ <p><dfn id=concept-http-equiv-extensions title=concept-http-equiv-extensions>Extensions to the
+ predefined set of pragma directives</dfn> may, under certain
+ conditions, be registered in the <a href=http://wiki.whatwg.org/wiki/PragmaExtensions>WHATWG Wiki
+ PragmaExtensions page</a>.</p>
+
+ <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
+ 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
+ the HTTP processing model (e.g. caching) must not be registered, as
+ they would result in HTTP-level behavior being different for user
+ agents that implement HTML than for user agents that do not.</p>
+
+ <p>Anyone is free to edit the WHATWG Wiki PragmaExtensions page at
+ any time to add a pragma directive satisfying these conditions. Such
+ registrations must specify the following information:</p>
+
+ <dl><dt>Keyword</dt>
+
+ <dd><p>The actual name being defined.</dd>
+
+
+ <dt>Brief description</dt>
+
+ <dd><p>A short description of the purpose of the pragma
+ directive.</dd>
+
+
+ <dt>Specification</dt>
+
+ <dd>A link to an IETF RFC defining the corresponding HTTP header.</dd>
+
+ </dl><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.</p>
+
+
+ <h5 id=charset><span class=secno>4.2.5.5 </span>Specifying the document's character encoding</h5>
+
<!-- XXX maybe the rest should move to "writing html" section,
though if we do then we have to duplicate the requirements in the
parsing section for conformance checkers -->
Modified: source
===================================================================
--- source 2008-12-20 09:21:43 UTC (rev 2547)
+++ source 2008-12-20 09:44:56 UTC (rev 2548)
@@ -9531,6 +9531,53 @@
any particular state in the document at a time.</p>
+ <h5>Other pragma directives</h5>
+
+ <p><dfn title="concept-http-equiv-extensions">Extensions to the
+ predefined set of pragma directives</dfn> may, under certain
+ conditions, be registered in the <a
+ href="http://wiki.whatwg.org/wiki/PragmaExtensions">WHATWG Wiki
+ PragmaExtensions page</a>.</p>
+
+ <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
+ requiring specific user agent processing, must not be registered;
+ instead, use <span title="concept-meta-extensions">metadata
+ names</span>. Pragma directions corresponding to headers that affect
+ the HTTP processing model (e.g. caching) must not be registered, as
+ they would result in HTTP-level behavior being different for user
+ agents that implement HTML than for user agents that do not.</p>
+
+ <p>Anyone is free to edit the WHATWG Wiki PragmaExtensions page at
+ any time to add a pragma directive satisfying these conditions. Such
+ registrations must specify the following information:</p>
+
+ <dl>
+
+ <dt>Keyword</dt>
+
+ <dd><p>The actual name being defined.</p></dd>
+
+
+ <dt>Brief description</dt>
+
+ <dd><p>A short description of the purpose of the pragma
+ directive.</p></dd>
+
+
+ <dt>Specification</dt>
+
+ <dd>A link to an IETF RFC defining the corresponding HTTP header.</dd>
+
+ </dl>
+
+ <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.</p>
+
+
<h5 id="charset">Specifying the document's character encoding</h5>
<!-- XXX maybe the rest should move to "writing html" section,
More information about the Commit-Watchers
mailing list