--- test/html-webhacc/error-description-source.xml	2008/08/30 16:10:07	1.41
+++ test/html-webhacc/error-description-source.xml	2008/09/14 03:09:23	1.45
@@ -56,8 +56,45 @@
 <section id="character-encoding-layer">
 <h2>Character Encoding Layer Errors</h2>
 
-<d:item name="illegal-octets-error" class="error-category-charset" level="m">
-  <d:message xml:lang="en">An illegal octet in the input stream.</d:message>
+<d:item name="fallback-char-error"
+    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>
 
@@ -177,10 +214,33 @@
 
 <d:item name="chardecode:fallback"
     modules="HTML::Parser">
-  <d:message xml:lang="en">Since no decoder for the document character
-  encoding is found, decoder for the character encoding
-  <code><var>{text}</var></code> is used.  Checking results might be
-  <em>wrong</em>.</d:message>
+  <d:message xml:lang="en">Results might be <em>wrong</em>, since the
+  conformance checker cannot find an appropriate decoder for the character
+  encoding used for the document.</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"
@@ -227,19 +287,64 @@
     </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">
@@ -760,6 +865,24 @@
 <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
@@ -1183,6 +1306,29 @@
   </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">
@@ -1452,8 +1598,23 @@
 
 <d:item name="element not allowed:meta charset"
     modules="ContentChecker::HTML">
-  <d:message xml:lang="en">The character encoding declaration must be the
-  first element in the <code>head</code> element.</d:message>
+  <d:message xml:lang="en">The character encoding declaration is not the
+  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"
@@ -1537,6 +1698,22 @@
 <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"
@@ -1661,16 +1838,41 @@
 <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>
@@ -2037,7 +2239,24 @@
 
 <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"
@@ -2465,23 +2684,26 @@
     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">
-    <p>The specified Internet Media Type is registered with status
-    of <i>OBSOLETE</i>.</p>
+  <d:message xml:lang="ja">廃止されたインターネット媒体型
+  <code><var>{value}</var></code> が使われています。</d:message>
+  <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
-      for many cases.</dd>
+      <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? -->  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"
@@ -3782,7 +4004,7 @@
   <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>
@@ -3998,6 +4220,6 @@
 and/or modify it under the same terms as Perl itself.</p>
 </section>
 
-<!-- $Date: 2008/08/30 16:10:07 $ -->
+<!-- $Date: 2008/09/14 03:09:23 $ -->
 </body>
 </html>
\ No newline at end of file