/[suikacvs]/test/html-webhacc/error-description-source.xml

Diff of /test/html-webhacc/error-description-source.xml

Parent Directory | Revision Log | View Patch Patch

-revision 1.40 by wakaba,
Sat Aug 30 05:32:51 2008 UTC
+revision 1.46 by wakaba,
Mon Sep 15 07:20:40 2008 UTC
 Line 56
  <section id="character-encoding-layer">
  <h2>Character Encoding Layer Errors</h2>
- <d:item name="illegal-octets-error" class="error-category-charset" level="m">
+ <d:item name="fallback-char-error"
-   <d:message xml:lang="en">An illegal octet in the input stream.</d:message>
+     modules="Charset::DecodeHandle">
+   <d:message xml:lang="en">Octet sequence <code><var>{octets}</var></code>
+   is not an allowed representation of the character
+   <code><var>{char}</var></code> &#x2014; character reference
+   <code><var>{char:hexref}</var></code> should be used instead.</d:message>
+   <!-- HTML5 parse error -->
+ </d:item>
+ <d:item name="fallback-unassigned-error"
+     modules="Charset::DecodeHandle">
+   <d:message xml:lang="en">No character is assigned to octet sequence
+   <code><var>{octets}</var></code>.</d:message>
+   <!-- HTML5 parse error -->
+ </d:item>
+ <d:item name="illegal-octets-error"
+     modules="Charset::DecodeHandle">
+   <d:message xml:lang="en">Octet sequence <code><var>{octets}</var></code>
+   is illegal.</d:message>
+ </d:item>
+ <d:item name="invalid-state-error"
+     modules="Charset::DecodeHandle::ISO2022JP">
+   <!-- TODO: more user-friendly error message is desired... -->
+   <d:message xml:lang="en">The input stream is broken.</d:message>
+   <d:desc xml:lang="en">
+     <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>
+   </d:desc>
+ </d:item>
+ <d:item name="unassigned-code-point-error"
+     modules="Charset::DecodeHandle">
+   <d:message xml:lang="en">No character is assigned to octet sequence
+   <code><var>{octets}</var></code>.</d:message>
  </d:item>
  </section>
-Line 177
+Line 214
  <d:item name="chardecode:fallback"
      modules="HTML::Parser">
-   <d:message xml:lang="en">Since no decoder for the document character
+   <d:message xml:lang="en">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.</d:message>
-   <em>wrong</em>.</d:message>
+   <d:desc xml:lang="en">
+     <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... -->
+   </d:desc>
  </d:item>
  <d:item name="chardecode:no error"
-Line 227
+Line 287
      </ul>
    </d:desc>
  </d:item>
+ </section>
+ <section id="character-set-layer">
+ <h2>Coded Character Set Layer Errors</h2>
  <d:item name="NULL"
      modules="HTML::Parser">
+   <!-- HTML5 Parse Error -->
    <d:message xml:lang="en">The <code class="charname">NULL</code> character
    is not allowed.</d:message>
  </d:item>
  <d:item name="control char"
-     modules="HTML::Parser">
+     modules="Charset::UnicodeChecker">
+   <!-- HTML5 Parse Error -->
    <d:message xml:lang="en">Code point <code><var>{text}</var></code> is
    not allowed.</d:message>
  </d:item>
+ <d:item name="nonchar"
+     modules="Charset::UnicodeChecker">
+   <d:message xml:lang="en">Noncharacter <code><var>{text}</var></code>
+   is found in the input stream.</d:message>
+   <d:desc xml:lang="en">
+     <p>Noncharacter code points are used in the input stream.</p>
+     <p>Noncharacter code points are reserved for internal processings.
+     Their use for information interchanges are forbidden.</p>
+     <p>In addition, they are not allowed in HTML document.</p>
+     <!-- "permanently undefined Unicode characters" in HTML5. -->
+   </d:desc>
+ </d:item>
+ <d:item name="non unicode"
+     modules="Charset::UnicodeChecker">
+   <d:message xml:lang="en">Character <code><var>{text}</var></code> is not
+   a Unicode character.</d:message>
+ </d:item>
+ <d:item name="unicode deprecated"
+     modules="Charset::UnicodeChecker">
+   <d:message xml:lang="en">Use of character <code><var>{text}</var></code>
+   is deprecated.</d:message>
+ </d:item>
+ <d:item name="unicode discouraged"
+     modules="Charset::UnicodeChecker">
+   <d:message xml:lang="en">Use of character <code><var>{text}</var></code>
+   is discouraged.</d:message>
+ </d:item>
+ <d:item name="unicode not preferred"
+     modules="Charset::UnicodeChecker">
+   <d:message xml:lang="en">Code point <code><var>{text}</var></code>
+   is not the preferred representation of that character.</d:message>
+ </d:item>
+ <d:item name="unicode should"
+     modules="Charset::UnicodeChecker">
+   <d:message xml:lang="en">Character <code><var>{text}</var></code>
+   should not be used in many cases.</d:message>
+ </d:item>
  </section>
  <section id="html5-tokenize-error">
-Line 256
+Line 367
    <d:message xml:lang="en">Attribute value must be quoted by <code>"</code>
    or <code>'</code> if it contains a <code>"</code>, <code>'</code>, or
    <code>=</code> character.</d:message>
+   <d:desc xml:lang="en">
+     <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=></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>
+   </d:desc>
  </d:item>
  <d:item name="bare ero"
-Line 503
+Line 630
  <d:item name="end tag attribute"
      modules="HTML::Parser">
    <d:message xml:lang="en">End tag cannot have attributes.</d:message>
+   <d:message xml:lang="ja">終了タグに属性が指定されています。</d:message>
+ </d:item>
+ <d:item name="empty unquoted attribute value"
+     modules="HTML::Parser">
+   <d:message xml:lang="en">Attribute value is not specified.</d:message>
+   <d:message xml:lang="ja">属性値が指定されていません。</d:message>
+   <d:desc xml:lang="en">
+     <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></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=""></code></p>
+     <p>... or like:</p>
+     <p><code class="html example">&lt;foo bar=''></code></p>
+   </d:desc>
  </d:item>
  <d:item name="invalid character reference"
-Line 718 
 p {
+Line 871 
 p {
  <section id="html5-parse-errors">
  <h2>HTML5 Parse Errors in Tree Construction Stage</h2>
+ <d:item name="after after frameset"
+     modules="HTML::Parser">
+   <d:message xml:lang="en">There is a start tag
+   <code>&lt;<var>{text}</var>></code> is after the <code>html</code> element
+   is closed.</d:message>
+   <d:message xml:lang="ja"><code>html</code> 要素が閉じられた後に開始タグ
+   <code>&lt;<var>{text}</var>></code> があります。</d:message>
+ </d:item>
+ <d:item name="after after frameset:/"
+     modules="HTML::Parser">
+   <d:message xml:lang="en">There is an end tag
+   <code>&lt;/<var>{text}</var>></code> is after the <code>html</code> element
+   is closed.</d:message>
+   <d:message xml:lang="ja"><code>html</code> 要素が閉じられた後に終了タグ
+   <code>&lt;/<var>{text}</var>></code> があります。</d:message>
+ </d:item>
  <d:item name="after body"
      modules="HTML::Parser">
    <d:message xml:lang="en">Start tag <code>&lt;<var>{text}</var>></code> is
-Line 1141 
 p {
+Line 1312 
 p {
    </d:desc>
  </d:item>
+ <d:item name="XSLT-compat"
+     modules="HTML::Parser">
+   <d:message xml:lang="en">The <code>DOCTYPE</code> legacy string is
+   used.</d:message>
+   <d:message xml:lang="ja"><code>DOCTYPE</code>
+   遺物文字列が使われています。</d:message>
+   <d:desc xml:lang="en">
+     <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"></code>
+     is used.</p>
+     <p>The <code>DOCTYPE</code> legacy string should not be used for documents
+     <em>not</em> 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>
+   </d:desc>
+ </d:item>
  </section>
  <section id="element-content-model-errors">
-Line 1410 
 p {
+Line 1604 
 p {
  <d:item name="element not allowed:meta charset"
      modules="ContentChecker::HTML">
-   <d:message xml:lang="en">The character encoding declaration must be the
+   <d:message xml:lang="en">The character encoding declaration is not the
-   first element in the <code>head</code> element.</d:message>
+   first child element in the <code>head</code> element.</d:message>
+   <d:message xml:lang="ja">文字符号化宣言が <code>head</code>
+   要素の最初の子要素ではありません。</d:message>
+   <d:desc xml:lang="en">
+     <p>The character encoding declaration
+     (<code class="html example">&lt;meta charset="<var>...</var>"></code> or
+     <code class="html example">&lt;meta http-equiv=Content-Type content="text/html; charset=<var>...</var>"></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>
+   </d:desc>
  </d:item>
  <d:item name="element not allowed:metadata"
-Line 1495 
 p {
+Line 1704 
 p {
  <d:item name="element not defined"
      modules="ContentChecker">
    <d:message xml:lang="en">This element is not defined.</d:message>
+   <d:message xml:lang="ja">この要素は定義されていません。</d:message>
+   <d:desc xml:lang="en">
+     <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>
+   </d:desc>
  </d:item>
  <d:item name="no significant content"
-Line 1619 
 p {
+Line 1844 
 p {
  <d:item name="attribute not defined"
      modules="ContentChecker">
    <d:message xml:lang="en">This attribute is not defined.</d:message>
+   <d:message xml:lang="ja">この属性は定義されていません。</d:message>
+   <d:desc xml:lang="en">
+     <p>The attribute is not one of attributes allowed for the element
+     in the latest version of relevant specifications.</p>
+     <p>The attribute cannot be used.</p>
+     <dl class="switch">
+     <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><br/><!--
+         --> /* JavaScript code */<br/><!--
+         -->&lt;/script></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"></code>.</dd>
+         <dt>VBScript</dt>
+           <dd>Use
+           <code class="html example">&lt;script type="text/vbscript"></code>.</dd>
+         </dl>
+       </dd>
+     </dl>
+   </d:desc>
  </d:item>
  <d:item name="in HTML:xml:lang"
-     class="attribute-error"
      modules="ContentChecker::XML">
-   <d:message xml:lang="en">The <code>xml:lang</code> attribute is not
+   <d:message xml:lang="en">The <code>xml:lang</code> attribute in HTML
-   allowed in HTML document.</d:message>
+   document is ignored.</d:message>
    <d:desc xml:lang="en">
-     <p>The <code>xml:lang</code> attribute is not allowed in
+     <p>The <code>xml:lang</code> attribute does not have an effect in
-     HTML document.  The document is non-conforming.</p>
+     HTML document.</p>
-     <p>Use of the <code>xml:lang</code> attribute is conforming
+     <p>The <code>xml:lang</code> attribute is only applicable to XML
-     <em>only</em> in XML documents.</p>
+     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 1663 
 p {
+Line 1925 
 p {
    </d:desc>
  </d:item>
- <d:item name="in XML:lang"
-     modules="ContentChecker::HTML">
-   <d:message xml:lang="en">The <code>lang</code> attribute is not
-   allowed in XML document.</d:message>
-   <d:desc>
-     <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>
-   </d:desc>
- </d:item>
  <d:item name="in XML:noscript"
      modules="ContentChecker::HTML">
    <d:message xml:lang="en">A <code>noscript</code> element cannot be
    used in XML document.</d:message>
  </d:item>
+ <d:item name="in XML:xml:lang"
+     modules="ContentChecker::HTML">
+   <d:message xml:lang="en">The <code>xml:lang</code> attribute in no namespace
+   is only allowed in HTML document.</d:message>
+   <d:message xml:lang="ja">名前空間に属さない <code>xml:lang</code>
+   属性が認められているのは HTML 文書中だけです。</d:message>
+ </d:item>
  <d:item name="in XML:xmlns"
      modules="ContentChecker::HTML">
    <d:message xml:lang="en">The <code>xmlns</code> attribute
-Line 1700 
 p {
+Line 1953 
 p {
    </d:desc>
  </d:item>
+ <d:item name="xml:lang not allowed"
+     modules="ContentChecker::HTML">
+   <d:message xml:lang="en">The <code>xml:lang</code> attribute is only allowed
+   when the <code>lang</code> attribute is specified.</d:message>
+   <d:message xml:lang="ja"><code>xml:lang</code> 属性を指定できるのは
+   <code>lang</code> 属性が指定されている時だけです。</d:message>
+ </d:item>
  </section>
  <section id="attribute-value-errors">
-Line 1906 
 p {
+Line 2167 
 p {
  <d:item name="dateortime:syntax error"
      modules="ContentChecker::HTML">
-   <d:message xml:lang="en">The attribute value is not a date or
+   <d:message xml:lang="en">The value is not a date or time.</d:message>
-   time.</d:message>
  </d:item>
  <d:item name="enumerated:invalid"
-Line 1985 
 p {
+Line 2245 
 p {
  <d:item name="empty attribute value"
      modules="ContentChecker::HTML">
-   <d:message xml:lang="en">The attribute value must not be empty.</d:message>
+   <d:message xml:lang="en">The attribute value is empty.</d:message>
+   <d:message xml:lang="ja">属性値が空です。</d:message>
+ </d:item>
+ <d:item name="empty style sheet title"
+     modules="ContentChecker::HTML">
+   <d:message xml:lang="en">The value of the <code>title</code> attribute
+   is empty.</d:message>
+   <d:message xml:lang="ja"><code>title</code> 属性の値が空です。</d:message>
+   <d:desc xml:lang="en">
+     <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>
+   </d:desc>
  </d:item>
  <d:item name="float:out of range"
-Line 2246 
 p {
+Line 2523 
 p {
 .0 <code>NCName</code>.</d:message>
  </d:item>
+ <d:item name="xml:lang ne lang"
+     modules="ContentChecker::XML ContentChecker::HTML">
+   <d:message xml:lang="en">The value of the <code>xml:lang</code> attribute
+   is different from the value of the <code>lang</code> attribute.</d:message>
+   <d:message xml:lang="ja"><code>xml:lang</code> 属性の値が <code>lang</code>
+   属性の値と異なります。</d:message>
+   <d:desc xml:lang="en">
+     <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>
+   </d:desc>
+   <d:desc xml:lang="ja">
+     <p><code>xml:lang</code> 属性 (<code>xml</code> (=
+     <code>http://www.w3.org/XML/1998/namespace</code>) 名前空間の
+     <code>lang</code> 属性や名前空間に属さない
+     <code>xml:lang</code> 属性) の値が同じ要素の名前空間に属さない
+     <code>lang</code> 属性の値と異なっています。</p>
+     <p>歴史的な理由により、 HTML 要素の言語指定のための属性は
+     <code>lang</code> と <code>xml:lang</code> の2つがあります。 HTML
+     文書では名前空間に属さない <code>lang</code> 属性だけが認められており、
+     かつ効力があります。名前空間に属さない
+     <code>xml:lang</code> 属性は HTML 文書では無視されます。 XHTML 文書では
+     <code>lang</code> 属性も <code>xml:lang</code> 属性も認められています。</p>
+     <p>通常、要素の言語情報は <em><code>lang</code>
+     属性だけ</em>を使って指定すれば十分です。</p>
+     <p><code>lang</code> 属性と <code>xml:lang</code>
+     属性の両方を同じ要素に指定する場合、
+     両者の値は同じでなければなりません。</p>
+   </d:desc>
+ </d:item>
  </section>
  <section id="table-model-errors">
-Line 2362 
 p {
+Line 2690 
 p {
      modules="IMTChecker">
    <d:message xml:lang="en">An obsolete Internet Media Type
    <code><var>{value}</var></code> is used.</d:message>
-   <d:item xml:lang="en">
+   <d:message xml:lang="ja">廃止されたインターネット媒体型
-     <p>The specified Internet Media Type is registered with status
+   <code><var>{value}</var></code> が使われています。</d:message>
-     of <i>OBSOLETE</i>.</p>
+   <d:desc xml:lang="en">
+     <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
-       <code>text/javascript</code> would be better alternative
+       <em><code>text/javascript</code></em> would be the better alternative
-       for many cases.</dd>
+       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? -->  Realist may ignore this warning.</dd>
+       purity.<!-- @@ ref? -->  Those who prefer reality to academic
+       purity <em>may ignore</em> this warning.</dd>
      </dl>
-   </d:item>
+   </d:desc>
  </d:item>
  <d:item name="IMT:parameter missing"
-Line 3679 
 p {
+Line 4010 
 p {
    <d:text xml:lang="ja">位置不明</d:text>
  </d:cat>
- <d:cat name="(Unknown)">
+ <d:cat name="(unknown)">
    <d:text xml:lang="en">(Unknown)</d:text>
    <d:text xml:lang="ja">(不明)</d:text>
  </d:cat>

 Legend:



Removed from v.1.40
 


changed lines


 
Added in v.1.46
 Legend:



Removed from v.1.40
 


changed lines


 
Added in v.1.46
-Removed from v.1.40
+Added in v.1.46

[email protected]	ViewVC Help
Powered by ViewVC 1.1.24