/[pub]/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.9 by wakaba, Mon Sep 3 14:30:46 2007 UTC revision 1.14 by wakaba, Wed Nov 7 11:29:46 2007 UTC
# Line 261  Web Document Conformance Checker (BETA)< Line 261  Web Document Conformance Checker (BETA)<
261    
262  <d:item name="nestc"  <d:item name="nestc"
263      class="tokenize-error">      class="tokenize-error">
264    <d:message xml:lang="en">Void element syntax (<code>/></code>) cannot be    <d:message xml:lang="en">Polytheistic slash (<code>/></code>) cannot be
265    used for this element.</d:message>    used for this element.</d:message>
266    <d:desc xml:lang="en">    <d:desc xml:lang="en">
267      <p>Void element syntax (<code>/></code>) must not be used      <p>Polytheistic slash (<code>/></code>) must not be used
268      for the element.  The document is non-conforming.</p>      for the element.  The document is non-conforming.</p>
269    
270      <p>The void element syntax can only be      <p>The polytheistic slash can only be
271      used for <code>base</code>, <code>link</code>, <code>meta</code>,      used for <code>base</code>, <code>link</code>, <code>meta</code>,
272      <code>hr</code>, <code>br</code>, <code>img</code>,      <code>hr</code>, <code>br</code>, <code>img</code>,
273      <code>embed</code>, <code>param</code>, <code>area</code>,      <code>embed</code>, <code>param</code>, <code>area</code>,
274      <code>col</code>, and <code>input</code> elements.</p>      <code>col</code>, and <code>input</code> elements.</p>
275    
276      <dl>      <dl class="switch">
277      <dt><code>&lt;script/></code></dt>      <dt><code>&lt;script/></code></dt>
278          <dd><p>The void element syntax cannot be used for <code>script</code>          <dd><p>The polytheistic slash cannot be used for <code>script</code>
279          element.  Even for an empty <code>script</code> element,          element.  Even for an empty <code>script</code> element,
280          there must be an explicit end tag <code>&lt;/script></code>.</p>          there must be an explicit end tag <code>&lt;/script></code>.</p>
281    
282          <p><strong>NOTE</strong>: Though some user agents interpret          <p><strong>NOTE</strong>: Though some user agents interpret
283          void element syntax for <code>script</code> element as the          polytheistic slash for <code>script</code> element as the
284          closing of the element, such usage is not allowed under          closing of the element, such usage is not allowed under
285          the current standard.</p></dd>          the current standard.</p></dd>
286      <dt><code>&lt;basefont/></code>, <code>&lt;bgsound/></code>,      <dt><code>&lt;basefont/></code>, <code>&lt;bgsound/></code>,
# Line 289  Web Document Conformance Checker (BETA)< Line 289  Web Document Conformance Checker (BETA)<
289          <dd>These elements are themselves non-conforming.</dd>          <dd>These elements are themselves non-conforming.</dd>
290      <!-- isindex, image -->      <!-- isindex, image -->
291      <dt><code>&lt;command/></code>, <code>&lt;event-source/></code>,      <dt><code>&lt;command/></code>, <code>&lt;event-source/></code>,
292      <code>&lt;source/></code></dt>      <code>&lt;nest/></code>, or <code>&lt;source/></code></dt>
293          <dd>Future revision of HTML5 parsing algorithm is expected          <dd>Future revision of HTML5 parsing algorithm is expected
294          to allow void element syntax for these elements.</dd>          to allow polytheistic slash for these elements.</dd>
295      <dt><code>&lt;a/></code>, <code>&lt;p/></code></dt>      <dt><code>&lt;a/></code>, <code>&lt;p/></code></dt>
296          <dd>These elements are not always empty and therefore          <dd>These elements are not always empty and therefore
297          void element syntax is not allowed.</dd>          polytheistic slash is not allowed.</dd>
298      </dl>      </dl>
299    
300      <p>Note that, unlike in XML, the void element syntax has      <p>Note that, unlike in XML, the polytheistic slash has
301      no effect in HTML.</p>      no effect in HTML.</p>
302    </d:desc>    </d:desc>
303  </d:item>  </d:item>
# Line 314  Web Document Conformance Checker (BETA)< Line 314  Web Document Conformance Checker (BETA)<
314      (<code>&lt;?xml-stylesheet <var>...</var>?></code>), are not allowed      (<code>&lt;?xml-stylesheet <var>...</var>?></code>), are not allowed
315      in the HTML syntax.  The document is non-conforming.</p>      in the HTML syntax.  The document is non-conforming.</p>
316    
317      <dl>      <dl class="switch">
318        <dt><code>&lt;?xbl?></code> (<abbr>XBL</abbr> Association)</dt>
319          <dd>An <abbr>XBL</abbr> binding cannot be associated by
320          <abbr title="processing instruction">PI</abbr> in <abbr>HTML</abbr>
321          document.  Use <code>binding</code> property in <abbr>CSS</abbr>
322          style sheet.</dd>
323      <dt><code>&lt;?xml?&gt;</code> (XML declaration)</dt>      <dt><code>&lt;?xml?&gt;</code> (XML declaration)</dt>
324          <dd>XML declaration is unnecessary for HTML documents.</dd>          <dd>XML declaration is unnecessary for HTML documents.</dd>
325      <dt><code>&lt;?xml-stylesheet?></code> (XML style sheet      <dt><code>&lt;?xml-stylesheet?></code> (XML style sheet
326      <abbr title="processing instruction">PI</abbr></dt>      <abbr title="processing instruction">PI</abbr>)</dt>
327          <dd>Use HTML <code>link</code> element with <code>rel</code>          <dd>Use HTML <code>link</code> element with <code>rel</code>
328          attribute set to <code>stylesheet</code> (or,          attribute set to <code>stylesheet</code> (or,
329          <code>alternate stylesheet</code> for an alternate style          <code>alternate stylesheet</code> for an alternate style
330          sheet).</dd>          sheet).</dd>
331      <dt><code>&lt;?php?&gt;</code> (PHP code)</dt>      <dt><code>&lt;?php?&gt;</code> or
332        <code>&lt;? <var>... <abbr>PHP</abbr> code ...</var> ?&gt;</code>
333        (<abbr>PHP</abbr> code)</dt>
334          <dd>The conformance checker does <em>not</em> support          <dd>The conformance checker does <em>not</em> support
335          checking for PHP source documents.</dd>          checking for PHP source documents.</dd>
336      <dt>Other processing instructions</dt>      <dt>Other processing instructions</dt>
# Line 470  Web Document Conformance Checker (BETA)< Line 477  Web Document Conformance Checker (BETA)<
477      </p>      </p>
478    
479      <p>Only white space characters and comments are allowed      <p>Only white space characters and comments are allowed
480      before the <code>DOCTYPE</code>.</p>      before the <code>DOCTYPE</code>.  XML declaration is <em>not</em>
481        allowed in HTML document.</p>
482    </d:desc>    </d:desc>
483  </d:item>  </d:item>
484    
# Line 482  Web Document Conformance Checker (BETA)< Line 490  Web Document Conformance Checker (BETA)<
490      <p>End tag of an element is not found before, for example,      <p>End tag of an element is not found before, for example,
491      an end tag of another element appears or      an end tag of another element appears or
492      the end of the document.  The document is non-conforming.</p>      the end of the document.  The document is non-conforming.</p>
493    
494        <p>Only <code>body</code>, <code>colgroup</code>, <code>dd</code>,
495        <code>dt</code>, <code>head</code>, <code>html</code>, <code>li</code>,
496        <code>ol</code>, <code>option</code>, <code>optgroup</code>,
497        <code>p</code>, <code>rb</code>, <code>rp</code>, <code>rt</code>,
498        <code>tbody</code>, <code>td</code>, <code>tfoot</code>,
499        <code>th</code>, <code>thead</code>, <code>tr</code>,
500        <code>ul</code> end tag can be omitted in HTML documents.
501        For any element except for void element, there must be an explicit
502        end tag.</p>
503    
504        <dl class="switch">
505        <dt>HTML <code>canvas</code> element</dt>
506          <dd>Though the element is void in earlier versions of Safari,
507          the <code>canvas</code> element is <em>no</em> longer
508          defined as empty.  There must be an end tag
509          <code>&lt;/canvas></code>.</dd>
510        </dl>
511    
512        <p>Note that misnesting tags, such as
513        <code class="bad example">&lt;a>&lt;b>&lt;/a>&lt;/b></code>, are not
514        allowed and they also cause this error.</p>
515    </d:desc>    </d:desc>
516  </d:item>  </d:item>
517    
# Line 530  Web Document Conformance Checker (BETA)< Line 560  Web Document Conformance Checker (BETA)<
560    
561      <p>For any end tag in HTML document, there must be a      <p>For any end tag in HTML document, there must be a
562      corresponding start tag.</p>      corresponding start tag.</p>
563    
564        <dl class="switch">
565        <dt>HTML <code>base</code>, <code>basefont</code>,
566        <code>bgsound</code>, <code>br</code>, <code>col</code>,
567        <code>embed</code>, <code>frame</code>, <code>hr</code>,
568        <code>image</code>, <code>img</code>, <code>input</code>,
569        <code>isindex</code>, <code>link</code>, <code>meta</code>,
570        <code>param</code>, <code>spacer</code>, or <code>wbr</code> element</dt>
571          <dd>End tag is not allowed for these elements, since
572          those content must always be empty.  Remove end tag.</dd>
573        <!-- keygen -->
574        <!-- command, event-source, nest, source -->
575        </dl>
576    </d:desc>    </d:desc>
577  </d:item>  </d:item>
578    
# Line 574  Web Document Conformance Checker (BETA)< Line 617  Web Document Conformance Checker (BETA)<
617      must contain a <code><var>$0</var></code> child element.      must contain a <code><var>$0</var></code> child element.
618      The document is non-conforming.</p>      The document is non-conforming.</p>
619    
620      <p>For example:      <dl class="switch">
621        <ul>      <dt>HTML <code>head</code> element</dt>
622        <li>The <code>head</code> element must contain exactly one        <dd>There must be a <code>title</code> child element.</dd>
623        <code>title</code> child element.</li>      <dt>HTML <code>html</code> element</dt>
624        <li><a href="#child-element-missing:td%7Cth">The <code>tr</code>        <dd>There must be a <code>head</code> child element followed
625        element must contain one or more <code>td</code> or <code>th</code>        by a <code>body</code> element.</dd>
626        child element.</a></li>      <dt>HTML <code>tr</code> element</dt>
627        </ul>        <dd><a href="#child-element-missing:td%7Cth">There must be
628      </p>        one or more <code>td</code> or <code>th</code> child element.</a></dd>
629        </dl>
630    </d:desc>    </d:desc>
631  </d:item>  </d:item>
632    
# Line 646  Web Document Conformance Checker (BETA)< Line 690  Web Document Conformance Checker (BETA)<
690            and in the <code>head</code> element.            and in the <code>head</code> element.
691            It cannot be used in e.g. <code>ul</code>, <code>table</code>,            It cannot be used in e.g. <code>ul</code>, <code>table</code>,
692            or <code>select</code>.</dd>            or <code>select</code>.</dd>
       <dt>If the element with the error is the <code>html</code> element  
       that is the root element of an XHTML document</dt>  
           <dd><p>In an XHTML document, the root <code>html</code>  
           element must have an <code>xmlns</code> attribute  
           whose value is set to  
           <code>http://www.w3.org/1999/xhtml</code>.</p></dd>  
693        <dt>If the element with the error is <code>blink</code>,        <dt>If the element with the error is <code>blink</code>,
694        <code>center</code>, or <code>marquee</code> element</dt>        <code>center</code>, or <code>marquee</code> element</dt>
695            <dd>These elements are not part of the HTML standard.            <dd>These elements are not part of the HTML standard.
696            Use CSS for styling control.</dd>            Use CSS for styling control.</dd>
697    
698        <dt><code>button</code>, <code>datalist</code>, <code>form</code>,        <dt><code>button</code>, <code>datalist</code>,
699          <code>fieldset</code>, <code>form</code>,
700        <code>input</code>, <code>label</code>,        <code>input</code>, <code>label</code>,
701        <code>optgroup</code>, <code>option</code>, <code>output</code>,        <code>optgroup</code>, <code>option</code>, <code>output</code>,
702        <code>rb</code>, <code>rp</code>, <code>rt</code>, <code>ruby</code>,        <code>rb</code>, <code>rp</code>, <code>rt</code>, <code>ruby</code>,
# Line 670  Web Document Conformance Checker (BETA)< Line 709  Web Document Conformance Checker (BETA)<
709    </d:desc>    </d:desc>
710  </d:item>  </d:item>
711    
712    <d:item name="element not allowed:root"
713        class="content-model-error">
714      <d:message xml:lang="en">This element is not allowed as a root
715      element.</d:message>
716      <d:desc xml:lang="en">
717        <p>An element that is not allowed as the root element
718        is used as the root element of the document.  The document is
719        non-conforming, as far as the conformance checker can tell.</p>
720    
721        <dl class="switch">
722        <dt><code>html</code> element in an XHTML document</dt>
723            <dd><p>In an XHTML document, the root <code>html</code>
724            element must have an <code>xmlns</code> attribute
725            whose value is set to
726            <code>http://www.w3.org/1999/xhtml</code>.</p></dd>
727        <dt><code>rss</code> element</dt>
728            <dd><p>The document is written in some version of RSS.</p>
729            <p>The conformance checker does not support any version
730            of RSS.  Use Atom 1.0 for feed documents.</p></dd>
731        <dt><code>feed</code> element</dt>
732            <dd><p>The Atom <code>feed</code> element must be
733            in the <code>http://www.w3.org/2004/Atom</code>
734            namespace.</p>
735            <p>The conformance checker does not support Atom 0.3.
736            Use Atom 1.0 for feed documents.</p></dd>
737        </dl>
738      </d:desc>
739    </d:item>
740    
741  <d:item name="ps element missing"  <d:item name="ps element missing"
742      class="content-model-error">      class="content-model-error">
743    <d:message xml:lang="en">There is no <code><var>$0</var></code>    <d:message xml:lang="en">There is no <code><var>$0</var></code>
# Line 837  Web Document Conformance Checker (BETA)< Line 905  Web Document Conformance Checker (BETA)<
905    </d:desc>    </d:desc>
906  </d:item>  </d:item>
907    
908    <d:item name="enumerated:invalid:http-equiv:content-type"
909        class="attribute-value-error">
910      <d:message xml:lang="en">Charset declaration syntax
911      <code>&lt;meta http-equiv="Content-Type" content="text/html; charset=<var>charset-name</var>"></code>
912      is obsolete.</d:message>
913      <d:desc xml:lang="en">
914        <p>Old long charset declaration syntax
915        <code>&lt;meta http-equiv="Content-Type" content="text/html; charset=<var>charset-name</var>"></code>
916        is in use.  The document is non‐conforming.</p>
917    
918        <p>The new charset declaration syntax is:
919          <pre><code>&lt;meta charset="<var>charset-name</var>"></code></pre>
920        </p>
921      </d:desc>
922    </d:item>
923    
924  <d:item name="duplicate ID"  <d:item name="duplicate ID"
925      class="attribute-value-error">      class="attribute-value-error">
926    <d:message xml:lang="en">This identifier has already been    <d:message xml:lang="en">This identifier has already been
# Line 869  Web Document Conformance Checker (BETA)< Line 953  Web Document Conformance Checker (BETA)<
953      <p>The specified link type is non-conforming, and therefore      <p>The specified link type is non-conforming, and therefore
954      the document is non-conforming.</p>      the document is non-conforming.</p>
955    
956      <dl>      <dl class="switch">
957      <dt>Link type <code>contents</code></dt>      <dt>Link type <code>contents</code></dt>
958        <dd>Use link type <code>index</code>.</dd>        <dd>Use link type <code>index</code>.</dd>
959      <dt>Link type <code>copyright</code></dt>      <dt>Link type <code>copyright</code></dt>
960        <dd>Use link type <code>license</code>.</dd>        <dd>Use link type <code>license</code>.</dd>
961      <dt>Link type <code>home</code></dt>      <dt>Link type <code>home</code></dt>
962        <dd>Use link type <code>index</code>.</dd>        <dd>Use link type <code>index</code>.</dd>
963        <dt>Link type <code>previous</code></dt>
964          <dd>Use link type <code>prev</code>.</dd>
965      <dt>Link type <code>start</code></dt>      <dt>Link type <code>start</code></dt>
966        <dd>Use link type <code>first</code>.</dd>        <dd>Use link type <code>first</code>.</dd>
967      <dt>Link type <code>toc</code></dt>      <dt>Link type <code>toc</code> or <code>top</code></dt>
968        <dd>Use link type <code>index</code>.</dd>        <dd>Use link type <code>index</code>.</dd>
969      </dl>      </dl>
970    </d:desc>    </d:desc>
# Line 921  Web Document Conformance Checker (BETA)< Line 1007  Web Document Conformance Checker (BETA)<
1007    
1008      <p><strong>Warning</strong>: The data served to the      <p><strong>Warning</strong>: The data served to the
1009      conforming checker might be out of date; it might have already      conforming checker might be out of date; it might have already
1010      been accepted or rejected, depending on which the document      been accepted or rejected.  The document might or might not be
1011      might be conforming or non-conforming.  See WHATWG Wiki      conforming depending on the status.  See WHATWG Wiki
1012      for the latest information.</p>      for the latest information.</p>
1013    </d:desc>    </d:desc>
1014  </d:item>  </d:item>
# Line 976  Web Document Conformance Checker (BETA)< Line 1062  Web Document Conformance Checker (BETA)<
1062      class="should" level="s">      class="should" level="s">
1063    <d:message xml:lang="en"><code><var>{@}</var></code>: An <em>obsolete</em>    <d:message xml:lang="en"><code><var>{@}</var></code>: An <em>obsolete</em>
1064    subtype is used.</d:message>    subtype is used.</d:message>
1065      <d:item xml:lang="en">
1066        <p>The specified Internet Media Type is registered with status
1067        of <i>OBSOLETE</i>.</p><!-- @@ SHOULD NOT? -->
1068        
1069        <dl class="swtich">
1070        <dt>Media type <code>text/ecmascript</code></dt>
1071          <dd>Media type <code>text/ecmascript</code> is obsoleted in
1072          favor of <code>application/ecmascript</code>.  Note that
1073          <code>text/javascript</code> would be better alternative
1074          for many cases.</dd>
1075        <dt>Media type <code>text/javascript</code></dt>
1076          <dd>Media type <code>text/javascript</code> is obsoleted by
1077          <abbr>IETF</abbr> with backward incompatible alternate
1078          <code>application/javascript</code> for architectural
1079          purity.<!-- @@ ref? -->  Realist may ignore this warning.</dd>
1080        </dl>
1081      </d:item>
1082  </d:item>  </d:item>
1083    
1084  <d:item name="IMT:private subtype"  <d:item name="IMT:private subtype"
# Line 1040  Web Document Conformance Checker (BETA)< Line 1143  Web Document Conformance Checker (BETA)<
1143      class="should" level="s">      class="should" level="s">
1144    <d:message xml:lang="en">This IRI does not end with    <d:message xml:lang="en">This IRI does not end with
1145    a <code>/</code>.</d:message>    a <code>/</code>.</d:message>
1146      <d:item xml:lang="en">
1147        <p>The IRI does not end with a <code>/</code>.  If there is an
1148        authority component in an IRI, a <code>/</code> should be present
1149        instead of empty path component.</p>
1150    
1151        <p>For example, <code>http://www.example.com<strong>/</strong></code>
1152        is preferred to <code>http://www.example.com</code>.</p>
1153      </d:item>
1154  </d:item>  </d:item>
1155    
1156  <d:item name="URI::lowercase hexadecimal digit"  <d:item name="URI::lowercase hexadecimal digit"
# Line 1086  Web Document Conformance Checker (BETA)< Line 1197  Web Document Conformance Checker (BETA)<
1197    
1198  </section>  </section>
1199    
1200    <section id="cache-manifest-errors">
1201    <h2>Cache Manifest Errors</h2>
1202    
1203    <d:item name="not manifest" class="must" level="m">
1204      <d:message xml:lang="en">This document is not a cache manifest.</d:message>
1205      <d:desc xml:lang="en">
1206        <p>The specified document is <em>not</em> a cache manifest.
1207        The document is non-conforming.</p>
1208    
1209        <p>An entity labeled as Internet media type
1210        <code>text/cache-manifest</code> must contain a cache manifest.</p>
1211    
1212        <p>A cache manifest must start with a line whose content is
1213        <code>CACHE MANIFEST</code> (exactly one space character between
1214        <code>CACHE</code> and <code>MANIFEST</code>).</p>
1215      </d:desc>
1216    </d:item>
1217    </section>
1218    
1219  <section id="unsupported-messages">  <section id="unsupported-messages">
1220  <h2><i>Unsupported</i> Messages</h2>  <h2><i>Unsupported</i> Messages</h2>
1221    
# Line 1144  Web Document Conformance Checker (BETA)< Line 1274  Web Document Conformance Checker (BETA)<
1274    is not supported; <em>it might or might not be conforming.</em></d:message>    is not supported; <em>it might or might not be conforming.</em></d:message>
1275  </d:item>  </d:item>
1276    
 <d:item name="language tag"  
     class="unsupported" level="unsupported">  
   <d:message xml:lang="en">Conformance checking for language tag  
   is not supported; <em>it might or might not be conforming.</em></d:message>  
 </d:item>  
   
1277  <d:item name="media query"  <d:item name="media query"
1278      class="unsupported" level="unsupported">      class="unsupported" level="unsupported">
1279    <d:message xml:lang="en">Conformance checking for media query    <d:message xml:lang="en">Conformance checking for media query
# Line 1181  manakaiIsHTML:1;;HTML Document Line 1305  manakaiIsHTML:1;;HTML Document
1305  manakaiIsHTML:0;;XML Document  manakaiIsHTML:0;;XML Document
1306  </d:catalog>  </d:catalog>
1307    
1308    <section id="levels">
1309    <h2>Error Levels</h2>
1310    
1311    <table id="levels-table">
1312    <thead>
1313    <tr><th scope="col">Level</th>
1314    <th scope="col">Conforming?</th>
1315    <th scope="col">Description</th>
1316    </tr>
1317    </thead>
1318    <tbody>
1319    <tr id="level-m" class="level-m">
1320    <th scope="row"><em class="rfc2119">MUST</em>‐level error</th>
1321    <td>Non‐conforming.</td>
1322    <td>A violation to a hard requirement of the specification.
1323    The document is non‐conforming.</td>
1324    </tr>
1325    <tr id="level-s" class="level-s">
1326    <th scope="row"><em class="rfc2119">SHOULD</em>‐level error</th>
1327    <td>Non‐conforming, but <em>in some case</em>
1328    conforming.</td>
1329    <td>A violation to a requirement of the specification.
1330    The violation might be legitimize in some case.  Otherwise,
1331    the document is non‐conforming.</td>
1332    </tr>
1333    <tr id="level-w" class="level-w">
1334    <th scope="row">Warning</th>
1335    <td>Conforming.</td>
1336    <td>A warning is an advice from the conformance checker to avoid
1337    to solve a problem in a confusing or possibly wrong way.
1338    It does not affect to the conformance of the document, and
1339    may sometimes be inappropriate.</td>
1340    </tr>
1341    <tr id="level-unsupported" class="level-unsupported">
1342    <th scope="row">Not supported</th>
1343    <td><em>Unknown</em>.</td>
1344    <td>Some feature that is not supported by the conformance checker
1345    is used in the document.</td>
1346    </tr>
1347    </tbody>
1348    </table>
1349    </section>
1350    
1351  <section id="license">  <section id="license">
1352  <h2>License of This Document</h2>  <h2>License of This Document</h2>
1353    
1354  <p>Copyright 2007 <a href="http://suika.fam.cx/~wakaba/who?" rel="author" xml:lang="ja">Wakaba</a></p>  <p>Copyright <time>2007</time>
1355    <a href="http://suika.fam.cx/~wakaba/who?" rel="author" xml:lang="ja">Wakaba</a>
1356    <code class="mail">&lt;<a href="mailto:w@suika.fam.cx">w@suika.fam.cx</a>></code>.</p>
1357    
1358  <p>This document is free software; you can redistribute it  <p>This document is free software; you can redistribute it
1359  and/or modify it under the same terms as Perl itself.</p>  and/or modify it under the same terms as Perl itself.</p>
1360  </section>  </section>
Legend:
Removed from v.1.9  
changed lines
  Added in v.1.14
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24