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

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.42 by wakaba, Sun Aug 31 13:28:12 2008 UTC revision 1.45 by wakaba, Sun Sep 14 03:09:23 2008 UTC
# Line 56  Line 56 
56  <section id="character-encoding-layer">  <section id="character-encoding-layer">
57  <h2>Character Encoding Layer Errors</h2>  <h2>Character Encoding Layer Errors</h2>
58    
59  <d:item name="illegal-octets-error" class="error-category-charset" level="m">  <d:item name="fallback-char-error"
60    <d:message xml:lang="en">An illegal octet in the input stream.</d:message>      modules="Charset::DecodeHandle">
61      <d:message xml:lang="en">Octet sequence <code><var>{octets}</var></code>
62      is not an allowed representation of the character
63      <code><var>{char}</var></code> &#x2014; character reference
64      <code><var>{char:hexref}</var></code> should be used instead.</d:message>
65      <!-- HTML5 parse error -->
66    </d:item>
67    
68    <d:item name="fallback-unassigned-error"
69        modules="Charset::DecodeHandle">
70      <d:message xml:lang="en">No character is assigned to octet sequence
71      <code><var>{octets}</var></code>.</d:message>
72      <!-- HTML5 parse error -->
73    </d:item>
74    
75    <d:item name="illegal-octets-error"
76        modules="Charset::DecodeHandle">
77      <d:message xml:lang="en">Octet sequence <code><var>{octets}</var></code>
78      is illegal.</d:message>
79    </d:item>
80    
81    <d:item name="invalid-state-error"
82        modules="Charset::DecodeHandle::ISO2022JP">
83      <!-- TODO: more user-friendly error message is desired... -->
84      <d:message xml:lang="en">The input stream is broken.</d:message>
85      <d:desc xml:lang="en">
86        <p>The input stream is encoded in <code>ISO-2022-JP</code>
87        or its variant but is partially broken.</p>
88    
89        <p>Note that an <code>ISO-2022-JP</code> stream must end in the ASCII
90        state.</p>
91      </d:desc>
92    </d:item>
93    
94    <d:item name="unassigned-code-point-error"
95        modules="Charset::DecodeHandle">
96      <d:message xml:lang="en">No character is assigned to octet sequence
97      <code><var>{octets}</var></code>.</d:message>
98  </d:item>  </d:item>
99  </section>  </section>
100    
# Line 177  Line 214 
214    
215  <d:item name="chardecode:fallback"  <d:item name="chardecode:fallback"
216      modules="HTML::Parser">      modules="HTML::Parser">
217    <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
218    encoding is found, decoder for the character encoding    conformance checker cannot find an appropriate decoder for the character
219    <code><var>{text}</var></code> is used.  Checking results might be    encoding used for the document.</d:message>
220    <em>wrong</em>.</d:message>    <d:desc xml:lang="en">
221        <p>The conformance checker cannot find an appropriate decoder for
222        the character encoding used to encode characters in the document.</p>
223    
224        <p>This error is raised if:</p>
225        <ul>
226        <li>the conformance checker cannot find any decoder for the character
227        encoding in use, but it knows that the encoding is similar to another
228        character encoding, such that it uses the decoder for that character
229        encoding, and therefore some octets might be interpreted incorrectly,
230        or,</li>
231        <li>the conformance checker find a decoder for the character encoding
232        in use, but it does not know whether the decoder is conforming to the
233        relevant specification or not, and therefore some octets might be
234        interpreted incorrectly.</li>
235        </ul>
236    
237        <p>In either case, the result shown by the conformance checker might
238        contain wrong errors caused by errorneous decoder or might not contain
239        errors that should be raised if an appropriate decoder is used.</p>
240    
241        <!-- TODO: add advise that either install relevant modules or
242             join the developmenet of the modules... -->
243      </d:desc>
244  </d:item>  </d:item>
245    
246  <d:item name="chardecode:no error"  <d:item name="chardecode:no error"
# Line 227  Line 287 
287      </ul>      </ul>
288    </d:desc>    </d:desc>
289  </d:item>  </d:item>
290    </section>
291    
292    <section id="character-set-layer">
293    <h2>Coded Character Set Layer Errors</h2>
294    
295  <d:item name="NULL"  <d:item name="NULL"
296      modules="HTML::Parser">      modules="HTML::Parser">
297      <!-- HTML5 Parse Error -->
298    <d:message xml:lang="en">The <code class="charname">NULL</code> character    <d:message xml:lang="en">The <code class="charname">NULL</code> character
299    is not allowed.</d:message>    is not allowed.</d:message>
300  </d:item>  </d:item>
301    
302  <d:item name="control char"  <d:item name="control char"
303      modules="HTML::Parser">      modules="HTML::Parser">
304      <!-- HTML5 Parse Error -->
305    <d:message xml:lang="en">Code point <code><var>{text}</var></code> is    <d:message xml:lang="en">Code point <code><var>{text}</var></code> is
306    not allowed.</d:message>    not allowed.</d:message>
307  </d:item>  </d:item>
308    
309    <d:item name="nonchar"
310        modules="Charset::UnicodeChecker">
311      <d:message xml:lang="en">Noncharacter <code><var>{text}</var></code>
312      is found in the input stream.</d:message>
313      <d:desc xml:lang="en">
314        <p>Noncharacter code points are used in the input stream.</p>
315    
316        <p>Noncharacter code points are reserved for internal processings.
317        Their use for information interchanges are forbidden.</p>
318    
319        <p>In addition, they are not allowed in HTML document.</p>
320        <!-- "permanently undefined Unicode characters" in HTML5. -->
321      </d:desc>
322    </d:item>
323    
324    <d:item name="unicode deprecated"
325        modules="Charset::UnicodeChecker">
326      <d:message xml:lang="en">Use of character <code><var>{text}</var></code>
327      is deprecated.</d:message>
328    </d:item>
329    
330    <d:item name="unicode discouraged"
331        modules="Charset::UnicodeChecker">
332      <d:message xml:lang="en">Use of character <code><var>{text}</var></code>
333      is discouraged.</d:message>
334    </d:item>
335    
336    <d:item name="unicode not preferred"
337        modules="Charset::UnicodeChecker">
338      <d:message xml:lang="en">Code point <code><var>{text}</var></code>
339      is not the preferred representation of that character.</d:message>
340    </d:item>
341    
342    <d:item name="unicode should"
343        modules="Charset::UnicodeChecker">
344      <d:message xml:lang="en">Character <code><var>{text}</var></code>
345      should not be used in many cases.</d:message>
346    </d:item>
347    
348  </section>  </section>
349    
350  <section id="html5-tokenize-error">  <section id="html5-tokenize-error">
# Line 1201  p { Line 1306  p {
1306    </d:desc>    </d:desc>
1307  </d:item>  </d:item>
1308    
1309    <d:item name="XSLT-compat"
1310        modules="HTML::Parser">
1311      <d:message xml:lang="en">The <code>DOCTYPE</code> legacy string is
1312      used.</d:message>
1313      <d:message xml:lang="ja"><code>DOCTYPE</code>
1314      遺物文字列が使われています。</d:message>
1315      <d:desc xml:lang="en">
1316        <p>The <code>DOCTYPE</code> with the <code>DOCTYPE</code> legacy
1317        string, i.e.
1318        <code class="html bad example">&lt;!DOCTYPE HTML PUBLIC "XSLT-compat"></code>
1319        is used.</p>
1320    
1321        <p>The <code>DOCTYPE</code> legacy string should not be used for documents
1322        <em>not</em> generated from XSLT transformation process.  It is allowed
1323        only to enable to use XSLT style sheets with the HTML output mode, which
1324        does not support generation of the <code>DOCTYPE</code> with no
1325        <code>PUBLIC</code>
1326        identifier.  For other purposes, the <code>DOCTYPE</code> legacy
1327        string, i.e. <code class="html bad example">PUBLIC "XSLT-compat"</code>,
1328        is useless and should not be used.</p>
1329      </d:desc>
1330    </d:item>
1331    
1332  </section>  </section>
1333    
1334  <section id="element-content-model-errors">  <section id="element-content-model-errors">
Legend:
Removed from v.1.42  
changed lines
  Added in v.1.45
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.24