/[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.13 by wakaba, Mon Nov 5 09:33:52 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 869  Web Document Conformance Checker (BETA)< Line 937  Web Document Conformance Checker (BETA)<
937      <p>The specified link type is non-conforming, and therefore      <p>The specified link type is non-conforming, and therefore
938      the document is non-conforming.</p>      the document is non-conforming.</p>
939    
940      <dl>      <dl class="switch">
941      <dt>Link type <code>contents</code></dt>      <dt>Link type <code>contents</code></dt>
942        <dd>Use link type <code>index</code>.</dd>        <dd>Use link type <code>index</code>.</dd>
943      <dt>Link type <code>copyright</code></dt>      <dt>Link type <code>copyright</code></dt>
944        <dd>Use link type <code>license</code>.</dd>        <dd>Use link type <code>license</code>.</dd>
945      <dt>Link type <code>home</code></dt>      <dt>Link type <code>home</code></dt>
946        <dd>Use link type <code>index</code>.</dd>        <dd>Use link type <code>index</code>.</dd>
947        <dt>Link type <code>previous</code></dt>
948          <dd>Use link type <code>prev</code>.</dd>
949      <dt>Link type <code>start</code></dt>      <dt>Link type <code>start</code></dt>
950        <dd>Use link type <code>first</code>.</dd>        <dd>Use link type <code>first</code>.</dd>
951      <dt>Link type <code>toc</code></dt>      <dt>Link type <code>toc</code> or <code>top</code></dt>
952        <dd>Use link type <code>index</code>.</dd>        <dd>Use link type <code>index</code>.</dd>
953      </dl>      </dl>
954    </d:desc>    </d:desc>
# Line 921  Web Document Conformance Checker (BETA)< Line 991  Web Document Conformance Checker (BETA)<
991    
992      <p><strong>Warning</strong>: The data served to the      <p><strong>Warning</strong>: The data served to the
993      conforming checker might be out of date; it might have already      conforming checker might be out of date; it might have already
994      been accepted or rejected, depending on which the document      been accepted or rejected.  The document might or might not be
995      might be conforming or non-conforming.  See WHATWG Wiki      conforming depending on the status.  See WHATWG Wiki
996      for the latest information.</p>      for the latest information.</p>
997    </d:desc>    </d:desc>
998  </d:item>  </d:item>
# Line 976  Web Document Conformance Checker (BETA)< Line 1046  Web Document Conformance Checker (BETA)<
1046      class="should" level="s">      class="should" level="s">
1047    <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>
1048    subtype is used.</d:message>    subtype is used.</d:message>
1049      <d:item xml:lang="en">
1050        <p>The specified Internet Media Type is registered with status
1051        of <i>OBSOLETE</i>.</p><!-- @@ SHOULD NOT? -->
1052        
1053        <dl class="swtich">
1054        <dt>Media type <code>text/ecmascript</code></dt>
1055          <dd>Media type <code>text/ecmascript</code> is obsoleted in
1056          favor of <code>application/ecmascript</code>.  Note that
1057          <code>text/javascript</code> would be better alternative
1058          for many cases.</dd>
1059        <dt>Media type <code>text/javascript</code></dt>
1060          <dd>Media type <code>text/javascript</code> is obsoleted by
1061          <abbr>IETF</abbr> with backward incompatible alternate
1062          <code>application/javascript</code> for architectural
1063          purity.<!-- @@ ref? -->  Realist may ignore this warning.</dd>
1064        </dl>
1065      </d:item>
1066  </d:item>  </d:item>
1067    
1068  <d:item name="IMT:private subtype"  <d:item name="IMT:private subtype"
# Line 1040  Web Document Conformance Checker (BETA)< Line 1127  Web Document Conformance Checker (BETA)<
1127      class="should" level="s">      class="should" level="s">
1128    <d:message xml:lang="en">This IRI does not end with    <d:message xml:lang="en">This IRI does not end with
1129    a <code>/</code>.</d:message>    a <code>/</code>.</d:message>
1130      <d:item xml:lang="en">
1131        <p>The IRI does not end with a <code>/</code>.  If there is an
1132        authority component in an IRI, a <code>/</code> should be present
1133        instead of empty path component.</p>
1134    
1135        <p>For example, <code>http://www.example.com<strong>/</strong></code>
1136        is preferred to <code>http://www.example.com</code>.</p>
1137      </d:item>
1138  </d:item>  </d:item>
1139    
1140  <d:item name="URI::lowercase hexadecimal digit"  <d:item name="URI::lowercase hexadecimal digit"
# Line 1086  Web Document Conformance Checker (BETA)< Line 1181  Web Document Conformance Checker (BETA)<
1181    
1182  </section>  </section>
1183    
1184    <section id="cache-manifest-errors">
1185    <h2>Cache Manifest Errors</h2>
1186    
1187    <d:item name="not manifest" class="must" level="m">
1188      <d:message xml:lang="en">This document is not a cache manifest.</d:message>
1189      <d:desc xml:lang="en">
1190        <p>The specified document is <em>not</em> a cache manifest.
1191        The document is non-conforming.</p>
1192    
1193        <p>An entity labeled as Internet media type
1194        <code>text/cache-manifest</code> must contain a cache manifest.</p>
1195    
1196        <p>A cache manifest must start with a line whose content is
1197        <code>CACHE MANIFEST</code> (exactly one space character between
1198        <code>CACHE</code> and <code>MANIFEST</code>).</p>
1199      </d:desc>
1200    </d:item>
1201    </section>
1202    
1203  <section id="unsupported-messages">  <section id="unsupported-messages">
1204  <h2><i>Unsupported</i> Messages</h2>  <h2><i>Unsupported</i> Messages</h2>
1205    
# Line 1144  Web Document Conformance Checker (BETA)< Line 1258  Web Document Conformance Checker (BETA)<
1258    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>
1259  </d:item>  </d:item>
1260    
 <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>  
   
1261  <d:item name="media query"  <d:item name="media query"
1262      class="unsupported" level="unsupported">      class="unsupported" level="unsupported">
1263    <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 1289  manakaiIsHTML:1;;HTML Document
1289  manakaiIsHTML:0;;XML Document  manakaiIsHTML:0;;XML Document
1290  </d:catalog>  </d:catalog>
1291    
1292    <section id="levels">
1293    <h2>Error Levels</h2>
1294    
1295    <table id="levels-table">
1296    <thead>
1297    <tr><th scope="col">Level</th>
1298    <th scope="col">Conforming?</th>
1299    <th scope="col">Description</th>
1300    </tr>
1301    </thead>
1302    <tbody>
1303    <tr id="level-m" class="level-m">
1304    <th scope="row"><em class="rfc2119">MUST</em>‐level error</th>
1305    <td>Non‐conforming.</td>
1306    <td>A violation to a hard requirement of the specification.
1307    The document is non‐conforming.</td>
1308    </tr>
1309    <tr id="level-s" class="level-s">
1310    <th scope="row"><em class="rfc2119">SHOULD</em>‐level error</th>
1311    <td>Non‐conforming, but <em>in some case</em>
1312    conforming.</td>
1313    <td>A violation to a requirement of the specification.
1314    The violation might be legitimize in some case.  Otherwise,
1315    the document is non‐conforming.</td>
1316    </tr>
1317    <tr id="level-w" class="level-w">
1318    <th scope="row">Warning</th>
1319    <td>Conforming.</td>
1320    <td>A warning is an advice from the conformance checker to avoid
1321    to solve a problem in a confusing or possibly wrong way.
1322    It does not affect to the conformance of the document, and
1323    may sometimes be inappropriate.</td>
1324    </tr>
1325    <tr id="level-unsupported" class="level-unsupported">
1326    <th scope="row">Not supported</th>
1327    <td><em>Unknown</em>.</td>
1328    <td>Some feature that is not supported by the conformance checker
1329    is used in the document.</td>
1330    </tr>
1331    </tbody>
1332    </table>
1333    </section>
1334    
1335  <section id="license">  <section id="license">
1336  <h2>License of This Document</h2>  <h2>License of This Document</h2>
1337    
1338  <p>Copyright 2007 <a href="http://suika.fam.cx/~wakaba/who?" rel="author" xml:lang="ja">Wakaba</a></p>  <p>Copyright <time>2007</time>
1339    <a href="http://suika.fam.cx/~wakaba/who?" rel="author" xml:lang="ja">Wakaba</a>
1340    <code class="mail">&lt;<a href="mailto:[email protected]">[email protected]</a>></code>.</p>
1341    
1342  <p>This document is free software; you can redistribute it  <p>This document is free software; you can redistribute it
1343  and/or modify it under the same terms as Perl itself.</p>  and/or modify it under the same terms as Perl itself.</p>
1344  </section>  </section>
Legend:
Removed from v.1.9  
changed lines
  Added in v.1.13
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.24