- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 04 Aug 2009 15:46:36 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/markup/src
In directory hutz:/tmp/cvs-serv21367/src
Modified Files:
attributes.html datatypes.html status.html terms.html
Log Message:
made a number of changes to documentation for datatypes
Index: status.html
===================================================================
RCS file: /sources/public/html5/markup/src/status.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -d -r1.10 -r1.11
--- status.html 2 Aug 2009 11:48:36 -0000 1.10
+++ status.html 4 Aug 2009 15:46:34 -0000 1.11
@@ -11,7 +11,7 @@
>HTML Design Principles</a>.</p>
<div>
<h2>Instability and incompleteness of this document</h2>
- <p>This document should in no way be considered stable. All
+ <p>This document should not be considered stable. All
parts of it remain subject to significant change or complete
removal. Also, this document should in no way be considered
complete. In particular, many elements in the
Index: terms.html
===================================================================
RCS file: /sources/public/html5/markup/src/terms.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- terms.html 2 Aug 2009 07:07:46 -0000 1.9
+++ terms.html 4 Aug 2009 15:46:34 -0000 1.10
@@ -35,6 +35,10 @@
<dd>Some embedded content elements can have fallback content:
content that is to be used when the embedded content cannot
be used (for example, when it is of an unsupported format).</dd>
+ <dt><dfn id="identify">identify</dfn></dt>
+ <dd>To <a href="#identify">identify</a> a particular element
+ means to reference that element by means of its
+ <a href="#common.attrs.id">id</a> attribute.</dd>
<dt><dfn id="newlines">newline</dfn></dt>
<dd>A <a href="#newlines">newline</a> may be represented as any
of the following:
Index: datatypes.html
===================================================================
RCS file: /sources/public/html5/markup/src/datatypes.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -d -r1.30 -r1.31
--- datatypes.html 21 Jul 2009 07:07:25 -0000 1.30
+++ datatypes.html 4 Aug 2009 15:46:34 -0000 1.31
@@ -46,33 +46,70 @@
<dl><dt>character</dt>
<dd><a href="#data-string">string</a></dd>
</dl>
- <dl><dt>browsing-context</dt>
- <dd><code class="regexp">()|([^_].*)</code></dd>
- </dl>
- <dl><dt>browsing-context-or-keyword</dt>
+ <dl><dt>browsing-context-name</dt>
<dd></dd>
<dd>
- <div class="datatype-desc">A string that is an
- <a href="#ascii-case-insensitive">ASCII case-insensitive</a>
- match for the regular expression
- <code class="regexp">()|([^_].*)|(_blank)|(_self)|(_parent)|(_top)</code>
+ <div class="datatype-desc">Any
+ <a href="#data-string">string</a>,
+ with the following restrictions:
+ <ul>
+ <li>must not start with a
+ "<code title="U+005F LOW LINE">_</code>"
+ character</li>
+ <li>must be at least one character long</li>
+ </ul>
</div>
</dd>
+ </dl>
+ <dl><dt>browsing-context-name-or-keyword</dt>
+ <dd></dd>
<dd>
- <div class="example">
- <p>Examples:</p>
- <pre><code>_blank</code>
-<code>_SELF</code>
-<code>_parent</code>
-<code>_TOP</code></pre>
+ <div class="datatype-desc">Any
+ <a href="#data-string">string</a>
+ that is either of the following:
+ <ul>
+ <li>a
+ <a href="#common.data.browsing-context-name">browsing-context-name</a></li>
+ <li>an <a href="#ascii-case-insensitive">ASCII
+ case-insensitive</a> match for one of the following literal strings:
+ <ul>
+ <li><code>_blank</code></li>
+ <li><code>_self</code></li>
+ <li><code>_parent</code></li>
+ <li><code>_top</code></li>
+ </ul>
+ </li>
+ </ul>
</div>
</dd>
</dl>
<dl><dt>id</dt>
- <dd><code class="regexp">\S+</code></dd>
+ <dd></dd>
+ <dd>
+ <div class="datatype-desc">Any
+ <a href="#data-string">string</a>,
+ with the following restrictions:
+ <ul>
+ <li>must be at least one character long</li>
+ <li>must not contain any
+ <a href="#space">space characters</a></li>
+ </ul>
+ </div>
+ </dd>
</dl>
<dl><dt>idref</dt>
- <dd><code class="regexp">\S+</code></dd>
+ <dd></dd>
+ <dd>
+ <div class="datatype-desc">Any
+ <a href="#data-string">string</a>,
+ with the following restrictions:
+ <ul>
+ <li>must be at least one character long</li>
+ <li>must not contain any
+ <a href="#space">space characters</a></li>
+ </ul>
+ </div>
+ </dd>
</dl>
<dl><dt>idrefs</dt>
<dd></dd>
@@ -80,45 +117,134 @@
<div class="datatype-desc">A
<a href="#space">space</a>-separated list of one or more
<a href="#common.data.idref">idref</a> instances.</div>
- </dd>
+ </dd>
</dl>
<dl><dt>name</dt>
- <dd><code class="regexp">\S+</code></dd>
+ <dd></dd>
+ <dd>
+ <div class="datatype-desc">Any
+ <a href="#data-string">string</a>,
+ with the following restrictions:
+ <ul>
+ <li>must be at least one character long</li>
+ <li>must not contain any
+ <a href="#space">space characters</a></li>
+ </ul>
+ </div>
+ </dd>
</dl>
<dl><dt>hash-name</dt>
<dd></dd>
<dd>
- <div class="datatype-desc">A valid <dfn
- id="hash-name">hash-name reference</dfn> to an element of
- type <i>type</i> is a string consisting of a
+ <div class="datatype-desc">A
+ valid
+ <dfn id="hash-name">hash-name reference</dfn>
+ to an element of
+ type <i>type</i> is a string that starts with a
"<code title="U+0023 NUMBER SIGN">#</code>"
- character followed by a string which
- exactly matches the value of the name attribute of an
- element in the document with type <i>type</i>.</div>
+ character, followed by a string which
+ exactly matches the value of the
+ <code class="attribute">name</code>
+ attribute of an element in the document with type
+ <i>type</i>.</div>
</dd>
</dl>
<dl><dt>integer</dt>
- <dd><code class="regexp">-?[0-9]+</code></dd>
+ <dd></dd>
+ <dd>
+ <div class="datatype-desc">One or more characters in the range
+ <code title="U+0030 DIGIT ZERO–U+0039 DIGIT NINE ">0—9</code>,
+ optionally prefixed with a
+ "<code title="U+002D HYPHEN-MINUS">-</code>"
+ character.</div>
+ </dd>
</dl>
<dl><dt>integer.positive</dt>
- <dd><code class="regexp">0*[1-9][0-9]*</code></dd>
+ <dd></dd>
+ <dd>
+ <div class="datatype-desc">Any
+ <a href="#common.data.integer.non-negative">non-negative integer</a>,
+ with the following restriction:
+ <ul>
+ <li>must be greater than zero</li>
+ </ul>
+ </div>
+ </dd>
</dl>
<dl><dt>integer.non-negative</dt>
- <dd><code class="regexp">[0-9]+</code></dd>
- </dl>
- <dl><dt>percent</dt>
- <dd><code
- class="regexp">(100)|([1-9]?[0-9](\.[0-9]+)?)%</code></dd>
+ <dd></dd>
+ <dd>
+ <div class="datatype-desc">One or more characters in the range
+ <code title="U+0030 DIGIT ZERO–U+0039 DIGIT NINE ">0—9</code>.</div>
+ </dd>
</dl>
<dl><dt>float</dt>
- <dd><code class="regexp">-?((\.[0-9]+)|([0-9]+(\.[0-9]*)?))</code></dd>
+ <dd></dd>
+ <dd>
+ <div class="datatype-desc">A float consists of the following
+ parts, in exactly the following order:
+ <ol>
+ <li>Optionally, the first character may be a
+ "<code title="U+002D HYPHEN-MINUS">-</code>"
+ character.</li>
+ <li>One or more characters in the range
+ "<code title="U+0030 DIGIT ZERO–U+0039 DIGIT NINE ">0—9</code>".</li>
+ <li>Optionally, the following parts, in exactly the
+ following order:
+ <ol>
+ <li>a
+ "<code title="U+002E FULL STOP">.</code>"
+ character</li>
+ <li>one or more characters in the range
+ "<code title="U+0030 DIGIT ZERO–U+0039 DIGIT NINE ">0—9</code>"</li>
+ </ol>
+ </li>
+ <li>Optionally, the following parts, in exactly the
+ following order:
+ <ol>
+ <li>a
+ "<code title="U+0065 LATIN SMALL LETTER E">e</code>"
+ character or
+ "<code title="U+0045 LATIN CAPITAL LETTER E">E</code>"
+ character</li>
+ <li>optionally, a
+ "<code title="U+002D HYPHEN-MINUS">-</code>"
+ character or
+ "<code title="U+002B PLUS SIGN">+</code>"
+ character</li>
+ <li>One or more characters in the range
+ "<code title="U+0030 DIGIT ZERO–U+0039 DIGIT NINE ">0—9</code>".</li>
+ </ol>
+ </li>
+ </ol>
+ </div>
+ </dd>
</dl>
<dl><dt>float.positive</dt>
- <dd><code class="regexp">0*((\.0*[1-9][0-9]*)|([1-9][0-9]*(\.[0-9]*)?))</code></dd>
+ <dd></dd>
+ <dd>
+ <div class="datatype-desc">A
+ <a href="#common.data.float.non-negative">non-negative float</a>,
+ with the following restriction:
+ <ul>
+ <li>must be greater than zero</li>
+ </ul>
+ </div>
+ </dd>
</dl>
<dl><dt>float.non-negative</dt>
- <dd><code
- class="regexp">((\.[0-9]+)|([0-9]+(\.[0-9]*)?))</code></dd>
+ <dd></dd>
+ <dd>
+ <div class="datatype-desc">A
+ <a href="#common.data.float">float</a>,
+ with the following restriction:
+ <ul>
+ <li>the first character may not be a
+ "<code title="U+002D HYPHEN-MINUS">-</code>"
+ character</li>
+ </ul>
+ </div>
+ </dd>
</dl>
<dl><dt>datetime</dt>
<dd></dd>
Index: attributes.html
===================================================================
RCS file: /sources/public/html5/markup/src/attributes.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- attributes.html 1 Aug 2009 19:52:08 -0000 1.7
+++ attributes.html 4 Aug 2009 15:46:34 -0000 1.8
@@ -6,6 +6,10 @@
<dl>
<dt id="common.attrs.id">id</dt>
<dd>A unique identifier for the element.</dd>
+ <dd>There must not be multiple elements in a document that
+ have the same
+ <a href="#common.attrs.id" class="attribute">id</a>
+ value.</dd>
</dl>
<dl>
<dt id="common.attrs.class">class</dt>
@@ -31,7 +35,8 @@
</dl>
<dl>
<dt id="common.attrs.contextmenu">contextmenu</dt>
- <dd>Specifies a
+ <dd><a href="#identify">Identifies</a>
+ a
<a href="#menu" class="element">menu</a>
with which to associate the element as a
<dfn
Received on Tuesday, 4 August 2009 15:46:50 UTC