HTML::DOM, version 0.036

HTML::DOM is a Perl implementation of the HTML Document Object Model

This is an alpha release.  So far,  the level-2 core,  HTML and event
DOM interfaces have been implemented,  and some of the level-2  style
sheet interfaces.


RECENT CHANGES

See the Changes file for the long version.

0.036
-----
Incompatible change:  A newly-created HTML::DOM  object no longer has
html, head and body elements. These are not created until open, write
or parse_file is called.
New features:
• New innerText method on HTML elements
• css_url_fetcher now returns the previously assigned value.
• css_url_fetcher no longer clobbers an existing link element handler,
  because it now uses a new, separate mechanism.
A long list of bug fixes.

0.035
-----
• getElementById can now once more see sub-elements of forms.
• The base method is no longer affected by  previous  regexp  matches.

0.034
-----
• A couple of incompatible changes that affect  only  those  who  are
  doing arcane things with this distribution.
• HTML::DOM’s title method no longer dies when the title element does
  not exist.
• Event dispatch no longer leaves junk in $@.
• We now preserve whitespace in the DOM.
• get_event_listeners works better with subclasses.
• getElementById  now works when the element’s ID attribute is set to
  a reference.


TO DO

- Finish Level 2 CSS support
- outerHTML/innerText?
- Other DOM interfaces (the rest of level 2, and level 3)
- HTML 5 stuff
- Write more complete documentation
- Write more tests
- Finishing checking for memory leaks (run all tests under
  Devel::Leak::Object)


INSTALLATION

The easiest way to install this module is to use the CPAN module or
the cpan script:

    [sudo] perl -MCPAN -e "install HTML::DOM"

    [sudo] cpan HTML::DOM

Or you can use the following:

    perl Makefile.PL
    make
    make test
    [sudo] make install


DEPENDENCIES

This module requires perl 5.8.2 or later and the following
Perl modules:

- Scalar::Util 1.14 or later
- Exporter 5.57 or later
- HTML::TreeBuilder and HTML::Element (both part of the HTML::Tree
  distribution) (tested with 3.23)
- URI (tested with 1.35)
- LWP 1.13 or later
- CSS::DOM 0.07 or later
- HTML::Encoding is required if the parse_file method is to be used.
- constant::lexical
- Hash::Util::FieldHash::Compat


DOCUMENTATION

After installing, you can find documentation for this module with the 
perldoc command.

    perldoc HTML::DOM

Or try using man (it's faster, in my experience):

    man HTML::DOM


COPYRIGHT AND LICENCE

Copyright (C) 2007-9 Father Chrysostomos

This program is free software; you may redistribute it and/or modify
it under the same terms as perl.
