/[suikacvs]/markup/html/whatpm/Whatpm/HTML.html

Diff of /markup/html/whatpm/Whatpm/HTML.html

Parent Directory | Revision Log | View Patch Patch

-revision 1.2 by wakaba,
Tue May  1 10:47:37 2007 UTC
+revision 1.7 by wakaba,
Sun Nov 11 04:59:35 2007 UTC
 Line 1
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  <html xmlns="http://www.w3.org/1999/xhtml">
  <head>
- <title>Whatpm::HTML - An HTML Parser</title>
+ <title>Whatpm::HTML - An HTML Parser and Serializer</title>
  <link rel="stylesheet" href="http://suika.fam.cx/www/style/html/pod.css" type="text/css" />
  <link rev="made" href="mailto:admin@suika.fam.cx" />
  </head>
 Line 17
          <li><a href="#synopsis">SYNOPSIS</a></li>
          <li><a href="#description">DESCRIPTION</a></li>
          <li><a href="#methods">METHODS</a></li>
+         <li><a href="#lowlevel_interface">LOW-LEVEL INTERFACE</a></li>
+         <ul>
+                 <li><a href="#application_cache_selection_algorithm_hook">Application Cache Selection Algorithm Hook</a></li>
+         </ul>
+         <li><a href="#error_reports">ERROR REPORTS</a></li>
          <li><a href="#to_do">TO DO</a></li>
          <li><a href="#see_also">SEE ALSO</a></li>
          <li><a href="#author">AUTHOR</a></li>
-Line 28
+Line 35
  <p>
  </p>
  <h1><a name="name">NAME</a></h1>
- <p>Whatpm::HTML - An HTML Parser</p>
+ <p>Whatpm::HTML - An HTML Parser and Serializer</p>
  <p>
  </p>
  <hr />
-Line 39
+Line 46
    my $s = q&lt;&lt;!DOCTYPE html&gt;&lt;html&gt;...&lt;/html&gt;&gt;;
    # $doc = an empty DOM |Document| object
    my $on_error = sub {
-     my $error_code = shift;
+     my %error = @_;
-     warn $error_code, &quot;\n&quot;;
+     warn $error{type}, &quot;\n&quot;;
    };
    Whatpm::HTML-&gt;parse_string ($s =&gt; $doc, $onerror);
-   ## Then, |$doc| is the DOM representation of |$s|.</pre>
+   ## Now, |$doc| is the DOM representation of |$s|.</pre>
  <p>
  </p>
  <hr />
-Line 92 
 This argument is optional; if missing, a
+Line 99 
 This argument is optional; if missing, a
  parse error makes that string being <code>warn</code>ed.</p>
  </dd>
  <dd>
+ <p><strong>NOTE</strong>: To be a conforming user agent, the code MUST either
+ abort the processing by throwing an exception at the first
+ invocation or MUST continue the processing until the parser
+ stops.</p>
+ </dd>
+ <dd>
  <p>The method returns the DOM <code>Document</code> object (i.e. the second argument).</p>
  </dd>
  <dd>
  <p>Note that the <code>Whatpm::NanoDOM</code> module provides a non-conforming
- implementation of DOM that only implements the subset that
+ implementation of DOM that only implements a subset that
  is necessary for the purpose of <code>Whatpm::HTML</code>'s parsing and
  serializing.
  With this module, creating a new HTML <code>Document</code> object
- from a string containing HTML document can be coded as:</p>
+ from a string containing HTML document might be coded as:</p>
  </dd>
  <dd>
  <pre>
-Line 109 
 from a string containing HTML document c
+Line 122 
 from a string containing HTML document c
    my $doc = Whatpm::HTML-&gt;parse_string
        ($s =&gt; Whatpm::NanoDOM::Document-&gt;new, $onerror);</pre>
  </dd>
- <p></p>
- <dt><strong><a name="item_get_inner_html"><em>$s</em> = Whatpm::HTML-&gt;get_inner_html (<em>$node</em>[, <em>$onerror</em>]);</a></strong><br />
- </dt>
- <dd>
- Return the HTML serialization of a DOM node <em>$node</em>.
- </dd>
- <dd>
- <p>The first argument, <em>$node</em>, MUST be a DOM <code>Document</code>,
- <code>Node</code>, or <code>DocumentFragment</code> object.</p>
- </dd>
- <dd>
- <p>The second argument, <em>$onerror</em>, MUST be a reference to the
- error handling code.  This code will be invoked if a descendant
- of <code>$node</code> is not of <code>Element</code>, <code>Text</code>, <code>CDATASection</code>,
- <code>Comment</code>, <code>DocumentType</code>, or <code>EntityReference</code> so
- that <code>INVALID_STATE_ERR</code> MUST be thrown.
- The code will be invoked with an argument, which is the node
- whose type is invalid.
- This argument is optional; if missing, any such
- node is simply ignored.</p>
- </dd>
- <dd>
- <p>The method returns a reference to the <code>inner_html</code> attribute
- value, i.e. the HTML serialization of the <code>$node</code>.</p>
- </dd>
  <p></p></dl>
  <p>
  </p>
  <hr />
+ <h1><a name="lowlevel_interface">LOW-LEVEL INTERFACE</a></h1>
+ <p>@@ TBW</p>
+ <p>
+ </p>
+ <h2><a name="application_cache_selection_algorithm_hook">Application Cache Selection Algorithm Hook</a></h2>
+ <p>Once a parser <em>$p</em> is instantiated by method <code>new</code>,
+ a <code>CODE</code> reference can be set to <code>$p-&gt;{application_cache_selection}</code>.
+ That <code>CODE</code> will be called back when the application cache selection
+ algorithm MUST be run per HTML5.  By default,
+ <code>$p-&gt;{application_cache_selection}</code> is set to an empty subroutine.</p>
+ <p>The subroutine will be invoked with an argument <em>manifest_uri</em>,
+ which is set to the manifest URI when the algorithm MUST be invoked
+ with a manifest URI, or is set to <code>undef</code> when the algorithm MUST
+ be invoked without no manifest URI.</p>
+ <p>
+ </p>
+ <hr />
+ <h1><a name="error_reports">ERROR REPORTS</a></h1>
+ <p>@@ TBW</p>
+ <p>The list of the error types is available in
+ Whatpm Error Types &lt;http://suika.fam.cx/gate/2005/sw/Whatpm%20Error%20Types&gt;.</p>
+ <p>
+ </p>
+ <hr />
  <h1><a name="to_do">TO DO</a></h1>
  <p>Tokenizer should emit a sequence of character tokens as one token
  to improve performance.</p>
  <p>A method that accepts a byte stream as an input.</p>
  <p>Charset detection algorithm.</p>
- <p>Setting inner_html.</p>
+ <p>Documentation for the setter of inner_html.</p>
  <p>And there are many ``TODO''s and ``ISSUE''s in the source code.</p>
  <p>
  </p>
  <hr />
  <h1><a name="see_also">SEE ALSO</a></h1>
- <p>Web Applications 1.0 Working Draft (aka HTML5)
+ <p>Whatpm &lt;http://suika.fam.cx/www/markup/html/whatpm/readme&gt;.</p>
- &lt;http://whatwg.org/html5&gt;.  (Revision 792, 1 May 2007)</p>
+ <p>Whatpm Error Types
- <p><a href="../Whatpm/NanoDOM.html">the Whatpm::NanoDOM manpage</a></p>
+ &lt;http://suika.fam.cx/gate/2005/sw/Whatpm%20Error%20Types&gt;.</p>
+ <p>HTML5 &lt;http://whatwg.org/html5&gt;.</p>
+ <p><a href="../Whatpm/HTML/Serializer.html">the Whatpm::HTML::Serializer manpage</a>.</p>
+ <p><a href="../Whatpm/NanoDOM.html">the Whatpm::NanoDOM manpage</a>.</p>
+ <p><a href="../Whatpm/ContentChecker/HTML.html">the Whatpm::ContentChecker::HTML manpage</a>.</p>
  <p>
  </p>
  <hr />

 Legend:



Removed from v.1.2
 


changed lines


 
Added in v.1.7
 Legend:



Removed from v.1.2
 


changed lines


 
Added in v.1.7
-Removed from v.1.2
+Added in v.1.7

admin@suikawiki.org	ViewVC Help
Powered by ViewVC 1.1.24