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

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

Parent Directory | Revision Log | View Patch Patch

-revision 1.1 by wakaba,
Tue May  1 10:36:06 2007 UTC
+revision 1.3 by wakaba,
Wed May  2 13:44:33 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>What::HTML - An HTML Parser</title>
+ <title>Whatpm::HTML - An HTML Parser</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 28
  <p>
  </p>
  <h1><a name="name">NAME</a></h1>
- <p>What::HTML - An HTML Parser</p>
+ <p>Whatpm::HTML - An HTML Parser</p>
  <p>
  </p>
  <hr />
  <h1><a name="synopsis">SYNOPSIS</a></h1>
  <pre>
-   use What::HTML;
+   use Whatpm::HTML;
    my $s = q&lt;&lt;!DOCTYPE html&gt;&lt;html&gt;...&lt;/html&gt;&gt;;
    # $doc = an empty DOM |Document| object
 Line 43
      warn $error_code, &quot;\n&quot;;
    };
-   What::HTML-&gt;parse_string ($s =&gt; $doc, $onerror);
+   Whatpm::HTML-&gt;parse_string ($s =&gt; $doc, $onerror);
    ## Then, |$doc| is the DOM representation of |$s|.</pre>
  <p>
  </p>
  <hr />
  <h1><a name="description">DESCRIPTION</a></h1>
- <p>The <code>What::HTML</code> module contains HTML parser and serializer.</p>
+ <p>The <code>Whatpm::HTML</code> module contains HTML parser and serializer.</p>
  <p>The HTML parser can be used to construct the DOM tree representation
  from an HTML document.  The parsing and tree construction are done
  as described in the Web Application 1.0 specification.</p>
 Line 58 
 as described in the Web Application 1.0
  of a DOM tree (or a tree fragment thereof).  The serialization
  is performed as described in the Web Applications 1.0 specification
  for <code>innerHTML</code> DOM attribute.</p>
- <p>This module is part of WHAT.pm - Perl Modules for
+ <p>This module is part of Whatpm - Perl Modules for
  Web Hypertext Application Technologies.</p>
  <p>
  </p>
  <hr />
  <h1><a name="methods">METHODS</a></h1>
  <dl>
- <dt><strong><a name="item_parse_string">[<em>$doc</em> =] What::HTML-&gt;parse_string (<em>$s</em>, <em>$doc</em>[, <em>$onerror</em>]);</a></strong><br />
+ <dt><strong><a name="item_parse_string">[<em>$doc</em> =] Whatpm::HTML-&gt;parse_string (<em>$s</em>, <em>$doc</em>[, <em>$onerror</em>]);</a></strong><br />
  </dt>
  <dd>
  Parse a string <em>$s</em> as an HTML document.
 Line 92 
 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>What::NanoDOM</code> module provides a non-conforming
+ <p>Note that the <code>Whatpm::NanoDOM</code> module provides a non-conforming
  implementation of DOM that only implements the subset that
- is necessary for the purpose of <code>What::HTML</code>'s parsing and
+ 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>
-   use What::HTML;
+   use Whatpm::HTML;
-   use What::NanoDOM;
+   use Whatpm::NanoDOM;
-   my $doc = What::HTML-&gt;parse_string ($s =&gt; What::NanoDOM-&gt;new, $onerror);</pre>
+   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> = What::HTML-&gt;get_inner_html (<em>$node</em>[, <em>$onerror</em>]);</a></strong><br />
+ <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>.
-Line 121 
 Return the HTML serialization of a DOM n
+Line 128 
 Return the HTML serialization of a DOM n
  <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>,
+ of <em>$node</em> 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
-Line 130 
 This argument is optional; if missing, a
+Line 137 
 This argument is optional; if missing, a
  node is simply ignored.</p>
  </dd>
  <dd>
- <p>The method returns the <code>inner_html</code> attribute
+ <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>
+ value, i.e. the HTML serialization of the <em>$node</em>.</p>
  </dd>
  <p></p></dl>
  <p>
-Line 148 
 to improve performance.</p>
+Line 155 
 to improve performance.</p>
  </p>
  <hr />
  <h1><a name="see_also">SEE ALSO</a></h1>
+ <p>Whatpm
+ &lt;http://suika.fam.cx/www/markup/html/whatpm/readme&gt;</p>
  <p>Web Applications 1.0 Working Draft (aka HTML5)
  &lt;http://whatwg.org/html5&gt;.  (Revision 792, 1 May 2007)</p>
- <p><a href="../What/NanoDOM.html">the What::NanoDOM manpage</a></p>
+ <p><a href="../Whatpm/NanoDOM.html">the Whatpm::NanoDOM manpage</a></p>
  <p>
  </p>
  <hr />

 Legend:



Removed from v.1.1
 


changed lines


 
Added in v.1.3
 Legend:



Removed from v.1.1
 


changed lines


 
Added in v.1.3
-Removed from v.1.1
+Added in v.1.3

admin@suikawiki.org	ViewVC Help
Powered by ViewVC 1.1.24