HTML::DOM, version 0.018

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

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


CHANGES IN THIS RELEASE

New features/miscellaneous changes:
• HTML::DOM’s defaultView attribute is now writable.
• HTML::DOM::View is now an inside-out class, so anything can subclass
  it;  and its ‘document’  attribute is writable.  The constructor has
  been removed.
• The location method has been added to HTML::DOM.
Bug fixes:
• innerHTML is now listed in %HTML::DOM::Interface.
• An element’s innerHTML now serialises text nodes that are direct
  children of the element properly.
• An obscure bug related to removeAttribute and DOMAttrModified
  events, described more fully in the Changes file.


TO DO

- Finish Level 2 Events support
- Finish Level 2 CSS support
- Finish DOM Level 0 event support (add event properties)
- outerHTML?
- Other DOM interfaces (the rest of level 2, and level 3)
- Support callback routines for creating DOM objects for frames.
- HTML 5 stuff
- Add the EventTarget interface to Attr
- Write more complete documentation
- Write more tests


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.05 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-8 Father Chrysostomos

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