/[pub]/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.41 by wakaba,
Sat Aug 30 16:10:07 2008 UTC
+revision 1.45 by wakaba,
Sun Sep 14 03:09:23 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">
+   <!-- 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="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 760 
 p {
+Line 865 
 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 1183 
 p {
+Line 1306 
 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 1452 
 p {
+Line 1598 
 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 1537 
 p {
+Line 1698 
 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 1661 
 p {
+Line 1838 
 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>
+     <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>
-Line 2037 
 p {
+Line 2239 
 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 2465 
 p {
+Line 2684 
 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 3782 
 p {
+Line 4004 
 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.41
 


changed lines


 
Added in v.1.45
 Legend:



Removed from v.1.41
 


changed lines


 
Added in v.1.45
-Removed from v.1.41
+Added in v.1.45

[email protected]	ViewVC Help
Powered by ViewVC 1.1.24