$Id: README,v 1.7 1999/05/23 17:37:05 kmacleod Exp $


			     libxml-perl

	   Collection of Perl modules for working with XML.


INTRODUCTION

    libxml-perl is a collection of smaller Perl modules, scripts, and
    documents for working with XML in Perl.  libxml-perl software
    works in combination with XML::Parser, PerlSAX, XML::DOM,
    XML::Grove and others.

    See the file Changes for user-visible changes and ChangeLog for
    detailed changes.  See the `examples' directory for examples.  POD
    style documentation is included in all non-alpha modules and
    scripts.  You should also be able to use the 'perldoc' utility to
    extract documentation from the module files directly.  HTML
    formatted docs are available at the libxml-perl home page
    <http://bitsko.slc.ut.us/libxml-perl/>.

    Newer versions of this module can be found on CPAN at
    <http://www.perl.com/CPAN/modules/by-module/XML/>.  To join the
    Perl-XML mailing list, send an email message to
    ListManager@ActiveState.com with the following text in the body:
    Subscribe Perl-XML

    View the Perl XML FAQ at
    <http://www.perlxml.com/faq/perl-xml-faq.html>.

    Copyright (C) 1998 Ken MacLeod
    This library is free software; you can redistribute it and/or
    modify it under the same terms as Perl itself.


MODULES

    The following modules are marked with their release status:

    STABLE -- has been in use for a while with few or no outstanding
              bugs
    BETA   -- interfaces are stable but there may still be bugs
    ALPHA  -- interfaces are changing, there may be lots of bugs, and
              there may not be docs available yet

    XML::Parser::PerlSAX       BETA
        XML::Parser::PerlSAX is a PerlSAX parser using XML::Parser
        (which uses James Clark's Expat XML Parser).

    XML::Handler::Sample       BETA
        XML::Handler::Sample is a PerlSAX handler that simply prints
        out the event names as they are parsed by a PerlSAX parser.
        It can be used for debugging or as a template for building new
        handlers.  XML::Handler::Sample contains handlers for all
        known parser events.

    XML::ESISParser            BETA
        XML::ESISParser is a validating PerlSAX parser using James
        Clark's `nsgmls' SGML/XML Parser.  ESISParser supports both
        XML and SGML document instances.  Unless you need validation,
        you should probably be using XML::Parser::PerlSAX or
        XML::Parser.

        XML::ESISParser with XML::Grove obsolete the
        SGML::SPGroveBuilder and SGML::Grove modules.

    Data::Grove                BETA
    Data::Grove::Parent        BETA
    Data::Grove::Visitor       BETA
        Data::Grove and it's helpers provide a base class for deeply
        nested or directed graph structures.  Used by XML::Grove (and
        others soon).

    XML::SAX2Perl              ALPHA
    XML::Perl2SAX              ALPHA
        SAX2Perl and Perl2SAX are SAX Parser<->DocumentHandler
        filters.  These modules translate parse events between the
        Java/CORBA style SAX methods and PerlSAX style methods.


DOCUMENTS

    PerlSAX
        This document defines a Perl binding to SAX 1.0.  PerlSAX-
        based parser modules implement and possibly extend the
        interface described in PerlSAX.

    UsingPerlSAX
        UsingPerlSAX is a brief introduction to PerlSAX using the
        XML::Parser::PerlSAX module.

    modules.xml
        modules.xml contains a listing of all Perl XML packages and
        their public modules categorized by several topics.


INSTALLATION

    In order to use this package you will need Perl version 5.005 or
    better.  Several other modules may also be required to use some
    modules in libxml-perl, including XML::Parser, XML::DOM, and
    XML::Grove.  These are all available in the XML module directory
    on CPAN.

<http://www.perl.com/CPAN/modules/by-module/XML/>

    You install libxml-perl, as you would install any perl module
    library, by running these commands:

        perl Makefile.PL
        make
        make test
        make install

    If you want to install a private copy of libxml-perl in your home
    directory, then you should try to produce the initial Makefile
    with something like this command:

        perl Makefile.PL PREFIX=~/perl

