/[suikacvs]/test/html-webhacc/error-description.en.html.u8

Diff of /test/html-webhacc/error-description.en.html.u8

Parent Directory | Revision Log | View Patch Patch

-revision 1.33 by wakaba,
Fri Aug 29 13:35:14 2008 UTC
+revision 1.38 by wakaba,
Thu Sep 11 09:13:57 2008 UTC
 Line 32
  <section id="character-encoding-layer">
  <h2>Character Encoding Layer Errors</h2>
- <div class="section" id="illegal-octets-error"><h3>An illegal octet in the input stream.</h3></div>
+ <div class="section" id="fallback-char-error"><h3>Octet sequence <code><var>{octets}</var></code>
+   is not an allowed representation of the character
+   <code><var>{char}</var></code> — character reference
+   <code><var>{char:hexref}</var></code> should be used instead.</h3></div>
+ <div class="section" id="fallback-unassigned-error"><h3>No character is assigned to octet sequence
+   <code><var>{octets}</var></code>.</h3></div>
+ <div class="section" id="illegal-octets-error"><h3>Octet sequence <code><var>{octets}</var></code>
+   is illegal.</h3></div>
+ <div class="section" id="invalid-state-error"><h3>The input stream is broken.</h3>
+     <p>The input stream is encoded in <code>ISO-2022-JP</code>
+     or its variant but is partially broken.</p>
+     <p>Note that an <code>ISO-2022-JP</code> stream must end in the ASCII
+     state.</p>
+   </div>
+ <div class="section" id="unassigned-code-point-error"><h3>No character is assigned to octet sequence
+   <code><var>{octets}</var></code>.</h3></div>
  </section>
  <section id="html5-character-encoding">
-Line 121
+Line 141
    for the character encoding of this document is found in the transfer
    procotol headers.</h3></div>
- <div class="section" id="chardecode:fallback"><h3>Since no decoder for the document character
+ <div class="section" id="chardecode:fallback"><h3>Results might be <em>wrong</em>, since the
-   encoding is found, decoder for the character encoding
+   conformance checker cannot find an appropriate decoder for the character
-   <code><var>{text}</var></code> is used.  Checking results might be
+   encoding used for the document.</h3>
-   <em>wrong</em>.</h3></div>
+     <p>The conformance checker cannot find an appropriate decoder for
+     the character encoding used to encode characters in the document.</p>
+     <p>This error is raised if:</p>
+     <ul>
+     <li>the conformance checker cannot find any decoder for the character
+     encoding in use, but it knows that the encoding is similar to another
+     character encoding, such that it uses the decoder for that character
+     encoding, and therefore some octets might be interpreted incorrectly,
+     or,</li>
+     <li>the conformance checker find a decoder for the character encoding
+     in use, but it does not know whether the decoder is conforming to the
+     relevant specification or not, and therefore some octets might be
+     interpreted incorrectly.</li>
+     </ul>
+     <p>In either case, the result shown by the conformance checker might
+     contain wrong errors caused by errorneous decoder or might not contain
+     errors that should be raised if an appropriate decoder is used.</p>
+     <!-- TODO: add advise that either install relevant modules or
+          join the developmenet of the modules... -->
+   </div>
  <div class="section" id="chardecode:no-error"><h3>Conformance error checking for the character
    encoding <code><var>{text}</var></code> is not supported.</h3></div>
-Line 161
+Line 203
      <li>Use <code>UTF-8</code>.</li>
      </ul>
    </div>
+ </section>
+ <section id="character-set-layer">
+ <h2>Coded Character Set Layer Errors</h2>
  <div class="section" id="NULL"><h3>The <code class="charname">NULL</code> character
    is not allowed.</h3></div>
-Line 168
+Line 214
  <div class="section" id="control-char"><h3>Code point <code><var>{text}</var></code> is
    not allowed.</h3></div>
- </section>
+ <div class="section" id="nonchar"><h3>Noncharacter <code><var>{text}</var></code>
+   is found in the input stream.</h3>
+     <p>Noncharacter code points are used in the input stream.</p>
- <section id="html5-tokenize-error">
+     <p>Noncharacter code points are reserved for internal processings.
- <h2>HTML5 Parse Errors in Tokenization Stage</h2>
+     Their use for information interchanges are forbidden.</p>
- <div class="section" id="after-html"><h3>Tag <code>&lt;<var>$0</var>&gt;</code>
+     <p>In addition, they are not allowed in HTML document.</p>
-   is not allowed after the end tag <code>&lt;/html&gt;</code>.</h3>
+     <!-- "permanently undefined Unicode characters" in HTML5. -->
-     <p>The start or end tag of an element appears after the
-     <code>html</code> element has been closed.  The document is
-     non-conforming.</p>
-     <p>Any content of the document other than comments
-     must be put into the <code>html</code> element.</p>
    </div>
- <div class="section" id="after-body"><h3>Tag <code>&lt;<var>$0</var>&gt;</code>
+ <div class="section" id="unicode-deprecated"><h3>Use of character <code><var>{text}</var></code>
-   is not allowed after the end tag <code>&lt;/body&gt;</code>.</h3>
+   is deprecated.</h3></div>
-     <p>The start or end tag of an element appears after the
-     <code>body</code> element has been closed.  The document is
-     non-conforming.</p>
-     <p>Any content of the document other than <code>head</code>
+ <div class="section" id="unicode-discouraged"><h3>Use of character <code><var>{text}</var></code>
-     contents and comments must be put into the <code>body</code>
+   is discouraged.</h3></div>
-     element.</p>
-   </div>
+ <div class="section" id="unicode-not-preferred"><h3>Code point <code><var>{text}</var></code>
+   is not the preferred representation of that character.</h3></div>
+ <div class="section" id="unicode-should"><h3>Character <code><var>{text}</var></code>
+   should not be used in many cases.</h3></div>
+ </section>
+ <section id="html5-tokenize-error">
+ <h2>HTML5 Parse Errors in Tokenization Stage</h2>
  <div class="section" id="bad-attribute-name"><h3>Attribute name cannot contain characters
    <code>"</code>, <code>'</code>, and <code>=</code>.</h3></div>
  <div class="section" id="bad-attribute-value"><h3>Attribute value must be quoted by <code>"</code>
    or <code>'</code> if it contains a <code>"</code>, <code>'</code>, or
-   <code>=</code> character.</h3></div>
+   <code>=</code> character.</h3>
+     <p>In an unquoted attribute value, a character <code>"</code>
+     (<code>U+0022</code> <code class="charname">QUOTATION MARK</code>),
+     <code>'</code> (<code>U+0026</code>
+     <code class="charname">APOSTROPHE</code>), or <code>=</code>
+     (<code>U+003D</code> <code class="charname">EQUAL SIGN</code>)
+     is contained.  These characters are not allowed in unquoted attribute
+     values, since they are used to quote attribute values or to separate
+     attribute name and value.</p>
+     <p>This error is also raised if one try to use empty attribute
+     value like <code class="html bad example">&lt;foo bar= baz=&gt;</code>;
+     in this example, <code class="html bad example">baz=</code> is
+     treated as an invalid attribute value for the attribute
+     <code class="html bad example">bar</code>, not as another attribute.</p>
+   </div>
  <div class="section" id="bare-ero"><h3>The <code>&amp;</code> character must
    be escaped as <code class="html example">&amp;amp;</code>.</h3>
-Line 409
+Line 472
  <div class="section" id="end-tag-attribute"><h3>End tag cannot have attributes.</h3></div>
+ <div class="section" id="empty-unquoted-attribute-value"><h3>Attribute value is not specified.</h3>
+     <p>The attribute value is not specified after the <code>=</code>
+     (<code>U+003C</code> <code class="charname">EQUAL SIGN</code>)
+     character.</p>
+     <p>When an attribute value is empty, the <code>=</code> character after
+     the attribute name must be specified as:</p>
+     <p><code class="html example">&lt;foo bar&gt;</code></p>
+     <p>Instead, quotation marks can be used to explicitly represent that
+     the attribute value is empty, as:</p>
+     <p><code class="html example">&lt;foo bar=""&gt;</code></p>
+     <p>... or like:</p>
+     <p><code class="html example">&lt;foo bar=''&gt;</code></p>
+   </div>
  <div class="section" id="invalid-character-reference"><h3>Character reference to
    <code><var>{text}</var></code> is not allowed.</h3></div>
-Line 563 
 p {
+Line 646 
 p {
  <section id="html5-parse-errors">
  <h2>HTML5 Parse Errors in Tree Construction Stage</h2>
+ <div class="section" id="after-after-frameset"><h3>There is a start tag
+   <code>&lt;<var>{text}</var>&gt;</code> is after the <code>html</code> element
+   is closed.</h3></div>
+ <div class="section" id="after-after-frameset:/"><h3>There is an end tag
+   <code>&lt;/<var>{text}</var>&gt;</code> is after the <code>html</code> element
+   is closed.</h3></div>
  <div class="section" id="after-body"><h3>Start tag <code>&lt;<var>{text}</var>&gt;</code> is
    not allowed after the <code>body</code> is closed.</h3></div>
-Line 590 
 p {
+Line 681 
 p {
    </div>
  <div class="section" id="after-html"><h3>Start tag <code>&lt;<var>{text}</var>&gt;</code> is
-   not allowed after the <code>html</code> is closed.</h3></div>
+   not allowed after the <code>html</code> is closed.</h3>
+     <p>The start tag of an element appears after the
+     <code>body</code> element has been closed.  The document is
+     non-conforming.</p>
+     <p>Any content of the document other than <code>head</code>
+     contents and comments must be put into the <code>body</code>
+     element.</p>
+   </div>
  <div class="section" id="after-html:/"><h3>End tag <code>&lt;/<var>{text}</var>&gt;</code> is
-   not allowed after the <code>html</code> is closed.</h3></div>
+   not allowed after the <code>html</code> is closed.</h3>
+     <p>The end tag of an element appears after the
+     <code>body</code> element has been closed.  The document is
+     non-conforming.</p>
+     <p>Any content of the document other than <code>head</code>
+     contents and comments must be put into the <code>body</code>
+     element.</p>
+   </div>
  <div class="section" id="after-html:#text"><h3>Non‐white‐space characters are not allowed
    after the <code>html</code> is closed.</h3></div>
-Line 825 
 p {
+Line 932 
 p {
      </dl>
    </div>
+ <div class="section" id="XSLT-compat"><h3>The <code>DOCTYPE</code> legacy string is
+   used.</h3>
+     <p>The <code>DOCTYPE</code> with the <code>DOCTYPE</code> legacy
+     string, i.e.
+     <code class="html bad example">&lt;!DOCTYPE HTML PUBLIC "XSLT-compat"&gt;</code>
+     is used.</p>
+     <p>The <code>DOCTYPE</code> legacy string should not be used for documents
+     generated from XSLT transformation process.  It is allowed only to enable
+     to use XSLT style sheets with the HTML output mode, which does not
+     support generation of the <code>DOCTYPE</code> with no <code>PUBLIC</code>
+     identifier.  For other purposes, the <code>DOCTYPE</code> legacy
+     string, i.e. <code class="html bad example">PUBLIC "XSLT-compat"</code>,
+     is useless and should not be used.</p>
+   </div>
  </section>
  <section id="element-content-model-errors">
-Line 1014 
 p {
+Line 1137 
 p {
  <div class="section" id="element-not-allowed:minus"><h3>This element is not allowed in this
    context.</h3></div>
- <div class="section" id="element-not-allowed:meta-charset"><h3>The character encoding declaration must be the
+ <div class="section" id="element-not-allowed:meta-charset"><h3>The character encoding declaration is not the
-   first element in the <code>head</code> element.</h3></div>
+   first child element in the <code>head</code> element.</h3>
+     <p>The character encoding declaration
+     (<code class="html example">&lt;meta charset="<var>...</var>"&gt;</code> or
+     <code class="html example">&lt;meta http-equiv=Content-Type content="text/html; charset=<var>...</var>"&gt;</code>
+     must be the first child element in the <code>head</code> element.</p>
+     <p>The character encoding declaration have to occur near the beginning
+     of the document to ensure that Web browsers can be determine the
+     character encoding of the document.</p>
+     <p>The <code>title</code> element and other metadata elements must
+     appear after any character encoding declaration is processed.</p>
+   </div>
  <div class="section" id="element-not-allowed:metadata"><h3>This element is not allowed where metadata
    content is expected.</h3></div>
-Line 1069 
 p {
+Line 1204 
 p {
  <div class="section" id="element-not-allowed:atom|TextConstruct"><h3>This element is not allowed in Text
    construct.</h3></div>
- <div class="section" id="element-not-defined"><h3>This element is not defined.</h3></div>
+ <div class="section" id="element-not-defined"><h3>This element is not defined.</h3>
+     <p>The element is not one of elements allowed
+     in the latest version of relevant specifications.</p>
+     <p>The element cannot be used.</p>
+     <dl class="switch">
+     <dt><code>event-source</code> element</dt>
+         <dd>The element was renamed as <em><code>eventsource</code>
+         element</em> (no hyphen).</dd>
+     <dt><code>m</code> element</dt>
+         <dd>The element was renamed as <em><code>mark</code>
+         element</em>.</dd>
+     </dl>
+   </div>
  <div class="section" id="no-significant-content"><h3>No significant content is contained
    in this element.</h3></div>
-Line 1151 
 p {
+Line 1300 
 p {
  <div class="section" id="attribute-not-allowed:ismap"><h3>The <code>ismap</code> attribute may only be
    used for the image contained in an <code>a</code> element.</h3></div>
- <div class="section" id="attribute-not-defined"><h3>This attribute is not defined.</h3></div>
+ <div class="section" id="attribute-not-defined"><h3>This attribute is not defined.</h3>
+     <p>The attribute is not one of attributes allowed for the element
+     in the latest version of relevant specifications.</p>
- <div class="section" id="in-HTML:xml:lang"><h3>The <code>xml:lang</code> attribute is not
+     <p>The attribute cannot be used.</p>
-   allowed in HTML document.</h3>
-     <p>The <code>xml:lang</code> attribute is not allowed in
-     HTML document.  The document is non-conforming.</p>
-     <p>Use of the <code>xml:lang</code> attribute is conforming
+     <dl class="switch">
-     <em>only</em> in XML documents.</p>
+     <dt><code>align</code> attribute (various HTML elements)</dt>
+     <dt><code>border</code> attribute (various HTML elements)</dt>
+       <dd>These attributes are no longer part of HTML.  You can use CSS
+       properties to control the presentation of the element.</dd>
+     <dt><code>autosubmit</code> attribute (<code>menu</code> element)</dt>
+       <dd>The attribute was part of HTML5 draft but then dropped.
+       Similar functionality can be implemented by scripts.</dd>
+     <dt><code>language</code> attribute (<code>script</code> element)</dt>
+       <dd>The attribute is no longer the standard way to specify the
+       scripting language.  If you are using JavaScript, then no explicit
+       specification of the scripting language is necessary, so you can
+       write the element like:
+         <p><code class="html example code">&lt;script&gt;<br><!--
+         --> /* JavaScript code */<br><!--
+         -->&lt;/script&gt;</code></p>
+       If you are using different scripting language from JavaScript, or
+       you want to declare the scripting language explicitly, you should
+       use the <code>type</code> attribute, as follows:
+         <dl class="switch">
+         <dt>JavaScript</dt>
+           <dd>Use
+           <code class="html example">&lt;script type="text/javascript"&gt;</code>.</dd>
+         <dt>VBScript</dt>
+           <dd>Use
+           <code class="html example">&lt;script type="text/vbscript"&gt;</code>.</dd>
+         </dl>
+       </dd>
+     </dl>
+   </div>
+ <div class="section" id="in-HTML:xml:lang"><h3>The <code>xml:lang</code> attribute in HTML
+   document is ignored.</h3>
+     <p>The <code>xml:lang</code> attribute does not have an effect in
+     HTML document.</p>
+     <p>The <code>xml:lang</code> attribute is only applicable to XML
+     documents.  In HTML document, it is only allowed to ease migration
+     from XML.</p>
      <p>To specify natural language information in HTML document,
      use <code>lang</code> attribute instead.</p>
-Line 1187 
 p {
+Line 1372 
 p {
      </p>
    </div>
- <div class="section" id="in-XML:lang"><h3>The <code>lang</code> attribute is not
-   allowed in XML document.</h3>
-     <p>The HTML <code>lang</code> attribute is not allowed in
-     XML document.  The document is non-conforming.</p>
-     <p>The <code>lang</code> attribute in <code>null</code>
-     namespace for HTML elements is conforming <em>only</em> in
-     HTML documents.</p>
-     <p>To specify natural language information in XML document,
-     use <code>xml:lang</code> attribute instead.</p>
-   </div>
  <div class="section" id="in-XML:noscript"><h3>A <code>noscript</code> element cannot be
    used in XML document.</h3></div>
+ <div class="section" id="in-XML:xml:lang"><h3>The <code>xml:lang</code> attribute in no namespace
+   is only allowed in HTML document.</h3></div>
  <div class="section" id="in-XML:xmlns"><h3>The <code>xmlns</code> attribute
    in the <code>null</code> namespace is not allowed in
    XHTML document.  The document is non-conforming.</h3>
-Line 1213 
 p {
+Line 1388 
 p {
      static documents.</p>
    </div>
+ <div class="section" id="xml:lang-not-allowed"><h3>The <code>xml:lang</code> attribute is only allowed
+   when the <code>lang</code> attribute is specified.</h3></div>
  </section>
  <section id="attribute-value-errors">
-Line 1345 
 p {
+Line 1523 
 p {
  <div class="section" id="datetime:syntax-error"><h3>The attribute value is not a datetime.</h3></div>
- <div class="section" id="dateortime:syntax-error"><h3>The attribute value is not a date or
+ <div class="section" id="dateortime:syntax-error"><h3>The value is not a date or time.</h3></div>
-   time.</h3></div>
  <div class="section" id="enumerated:invalid"><h3>This attribute only allow a limited set of
    values and the specified value <code><var>{@}</var></code> is not one
-Line 1401 
 p {
+Line 1578 
 p {
  <div class="section" id="duplicate-token"><h3>The token <code><var>{value}</var></code>
    appears in the attribute value twice.</h3></div>
- <div class="section" id="empty-attribute-value"><h3>The attribute value must not be empty.</h3></div>
+ <div class="section" id="empty-attribute-value"><h3>The attribute value is empty.</h3></div>
+ <div class="section" id="empty-style-sheet-title"><h3>The value of the <code>title</code> attribute
+   is empty.</h3>
+     <p>The <code>title</code> attribute value of the <code>link</code>
+     element that defines an alternate style sheet is an empty value.</p>
+     <p>A <code>link</code> element whose <code>rel</code> attribute
+     is <code>alternate stylesheet</code> defines an alternate style sheet.
+     An alternate style sheet must be associated with a name using the
+     <code>title</code> attribute.  The name cannot be empty.</p>
+   </div>
  <div class="section" id="float:out-of-range"><h3>The specified value is out of range.</h3></div>
-Line 1556 
 p {
+Line 1744 
 p {
  <div class="section" id="XML-1.0-NCName:syntax-error"><h3>The specified value is not a legal XML Namespaces
 .0 <code>NCName</code>.</h3></div>
+ <div class="section" id="xml:lang-ne-lang"><h3>The value of the <code>xml:lang</code> attribute
+   is different from the value of the <code>lang</code> attribute.</h3>
+     <p>The value of the <code>xml:lang</code> attribute (either the
+     <code>lang</code> attribute in the <code>xml</code> (i.e.
+     <code>http://www.w3.org/XML/1998/namespace</code>) namespace, or
+     the <code>xml:lang</code> attribute in no namespace) for the element has
+     different value than that of the <code>lang</code> attribute in no
+     namespace.</p>
+     <p>For historical reason, there are two attributes applicable to HTML
+     elements to specify language information of an element: <code>lang</code>
+     and <code>xml:lang</code>.  In HTML documents, only <code>lang</code>
+     attribute in no namespace is allowed and take effect; the
+     <code>xml:lang</code> attribute in no namespace is ignored in HTML
+     documents.  In XHTML documents, both <code>lang</code> and
+     <code>xml:lang</code> attributes are allowed.</p>
+     <p>In general, <em>only the <code>lang</code> attribute</em> need to be
+     specified for an element.</p>
+     <p>If both <code>lang</code> and <code>xml:lang</code> attributes are
+     specified on the same element, their values must be the same value.</p>
+   </div>
  </section>
  <section id="table-model-errors">
-Line 1627 
 p {
+Line 1839 
 p {
    <code><var>{value}</var></code> is used.</h3></div>
  <div class="section" id="IMT:obsolete-subtype"><h3>An obsolete Internet Media Type
-   <code><var>{value}</var></code> is used.</h3></div>
+   <code><var>{value}</var></code> is used.</h3>
+     <p>The specified Internet Media Type is registered with its intended
+     usage as <i>OBSOLETE</i>.</p>
+     <dl class="swtich">
+     <dt>Media type <code>text/ecmascript</code></dt>
+       <dd>Media type <code>text/ecmascript</code> is obsoleted in
+       favor of <code>application/ecmascript</code>.  Note that
+       <em><code>text/javascript</code></em> would be the better alternative
+       in many cases.</dd>
+     <dt>Media type <code>text/javascript</code></dt>
+       <dd>Media type <code>text/javascript</code> is obsoleted by
+       <abbr>IETF</abbr> with backward incompatible alternate
+       <code>application/javascript</code> for architectural
+       purity.<!-- @@ ref? -->  Those who prefer reality to academic
+       purity <em>may ignore</em> this warning.</dd>
+     </dl>
+   </div>
  <div class="section" id="IMT:parameter-missing"><h3>Parameter <code><var>{text}</var></code> have to
    be specified for the Internet Media Type
-Line 1703 
 p {
+Line 1932 
 p {
    URI.</h3></div>
  <div class="section" id="URL:address-format"><h3>URL host address format
-   <code><var>{value}</var></code> is not supported by the
+   <code><var>{text}</var></code> is not defined.</h3></div>
-   conformance checker.</h3></div>
  <div class="section" id="URL:default-port"><h3>Default port number should be omitted.</h3></div>

 Legend:



Removed from v.1.33
 


changed lines


 
Added in v.1.38
 Legend:



Removed from v.1.33
 


changed lines


 
Added in v.1.38
-Removed from v.1.33
+Added in v.1.38

[email protected]	ViewVC Help
Powered by ViewVC 1.1.24