|
Packit |
d27c7e |
<HTML>
|
|
Packit |
d27c7e |
<HEAD>
|
|
Packit |
d27c7e |
<TITLE>libxml-perl</TITLE>
|
|
Packit |
d27c7e |
<META NAME="keywords" CONTENT="XML SGML Perl libxml libxml-perl">
|
|
Packit |
d27c7e |
</HEAD>
|
|
Packit |
d27c7e |
<BODY>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="6">libxml-perl</font>
|
|
Packit |
d27c7e |
Current version is @VERSION@
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
libxml-perl is a collection of Perl modules,
|
|
Packit |
d27c7e |
scripts, and documents for working with XML in Perl. libxml-perl
|
|
Packit |
d27c7e |
software works in combination with XML::Parser, PerlSAX, XML::DOM,
|
|
Packit |
d27c7e |
XML::Grove, and others.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
Questions about how to use this library should be directed to the
|
|
Packit |
d27c7e |
<TT>comp.lang.perl.modules</TT> USENET Newsgroup. Bug reports and
|
|
Packit |
d27c7e |
suggestions for improvements can be sent to the
|
|
Packit |
d27c7e |
<perl-xml@activestate.com> mailing list. This mailing list is
|
|
Packit |
d27c7e |
also the place for general discussions and development of the
|
|
Packit |
d27c7e |
libxml-perl package.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
To join the Perl-XML mailing list, send an email message to
|
|
Packit |
d27c7e |
ListManager@ActiveState.com with the following text in the body:
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
Subscribe Perl-XML
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="5" face="Helvetica,Arial">Source</font>
|
|
Packit |
d27c7e |
libxml-perl source is available on CPAN in the
|
|
Packit |
d27c7e |
href="http://www.perl.com/CPAN/modules/by-module/XML/">XML module
|
|
Packit |
d27c7e |
directory. This link goes through the CPAN redirector so if the
|
|
Packit |
d27c7e |
site gives you any problems, just click it again and you will be
|
|
Packit |
d27c7e |
redirected to a different site.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
libxml-perl source is also available
|
|
Packit |
d27c7e |
href="libxml-perl-@VERSION@.tar.gz">here.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
The libxml-perl-@VERSION@ README
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="5" face="Helvetica,Arial">Modules</font>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
The following modules are part of libxml-perl. Below they are marked with their release status:
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
STABLEhas been in use for a while with few or no outstanding bugs
|
|
Packit |
d27c7e |
BETAinterfaces are stable but there may still be bugs
|
|
Packit |
d27c7e |
ALPHAinterfaces are changing, there may be lots of bugs, and there may not be docs available yet
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::Parser::PerlSAX</font>
|
|
Packit |
d27c7e |
<font size="2"> BETA</font>
|
|
Packit |
d27c7e |
XML::Parser::PerlSAX is a PerlSAX parser using XML::Parser (which uses James Clark's Expat XML Parser).
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::Handler::XMLWriter</font>
|
|
Packit |
d27c7e |
<font size="2"> BETA</font>
|
|
Packit |
d27c7e |
A PerlSAX handler for writing readable XML (in contrast to Canonical
|
|
Packit |
d27c7e |
XML, for example). XMLWriter is also subclassable and supports
|
|
Packit |
d27c7e |
calling start and end methods by element-names (subclassed from
|
|
Packit |
d27c7e |
XML::Handler::Subs). XMLWriter is similar to XML::Parser's Stream
|
|
Packit |
d27c7e |
style.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::Handler::Subs</font>
|
|
Packit |
d27c7e |
<font size="2"> BETA</font>
|
|
Packit |
d27c7e |
A PerlSAX handler base class that calls start and end methods by
|
|
Packit |
d27c7e |
element-names. Subs is similar to XML::Parser's Subs style.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::Handler::CanonXMLWriter</font>
|
|
Packit |
d27c7e |
<font size="2"> BETA</font>
|
|
Packit |
d27c7e |
XML::Handler::CanonXMLWriter is a PerlSAX handler that outputs in
|
|
Packit |
d27c7e |
HREF="http://www.jclark.com/xml/canonxml.html">Canonical
|
|
Packit |
d27c7e |
XML.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::Handler::Sample</font>
|
|
Packit |
d27c7e |
<font size="2"> BETA</font>
|
|
Packit |
d27c7e |
XML::Handler::Sample is a PerlSAX handler that simply prints out the
|
|
Packit |
d27c7e |
event names as they are parsed by a PerlSAX parser. It can be used for
|
|
Packit |
d27c7e |
debugging or as a template for building new handlers.
|
|
Packit |
d27c7e |
XML::Handler::Sample contains handlers for all known parser events.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::ESISParser</font>
|
|
Packit |
d27c7e |
<font size="2"> BETA</font>
|
|
Packit |
d27c7e |
XML::ESISParser is a validating PerlSAX parser using James Clark's
|
|
Packit |
d27c7e |
`nsgmls' SGML/XML Parser. ESISParser supports both XML and SGML
|
|
Packit |
d27c7e |
document instances. Unless you need validation, you should probably
|
|
Packit |
d27c7e |
be using XML::Parser::PerlSAX or XML::Parser.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
XML::ESISParser with XML::Grove obsolete the SGML::SPGroveBuilder and SGML::Grove modules.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">Data::Grove, Data::Grove::Parent, Data::Grove::Visitor</font>
|
|
Packit |
d27c7e |
<font size="2"> BETA</font>
|
|
Packit |
d27c7e |
Data::Grove and it's helpers provide a base class for deeply nested or
|
|
Packit |
d27c7e |
directed graph structures. Used by XML::Grove (and others soon).
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::SAX2Perl, XML::Perl2SAX</font>
|
|
Packit |
d27c7e |
<font size="2"> ALPHA</font>
|
|
Packit |
d27c7e |
SAX2Perl and Perl2SAX are SAX Parser<->DocumentHandler filters. These
|
|
Packit |
d27c7e |
modules translate parse events between the Java/CORBA style SAX
|
|
Packit |
d27c7e |
methods and PerlSAX style methods.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
The following modules will very likely be renamed in the next release.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::PatAct::MatchName</font>
|
|
Packit |
d27c7e |
<font size="2"> ALPHA</font>
|
|
Packit |
d27c7e |
MatchName is a pattern matching module that can be used with PatAct
|
|
Packit |
d27c7e |
action modules. MatchName uses simple element names or element name
|
|
Packit |
d27c7e |
lists to match names to actions.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::PatAct::ToObjects</font>
|
|
Packit |
d27c7e |
<font size="2"> ALPHA</font>
|
|
Packit |
d27c7e |
ToObjects is a PatAct action module. ToObjects can be used to create
|
|
Packit |
d27c7e |
application-ready Perl objects from XML instances.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::PatAct::Amsterdam</font>
|
|
Packit |
d27c7e |
<font size="2"> ALPHA</font>
|
|
Packit |
d27c7e |
Amsterdam is a PatAct action module. Amsterdam can be used to apply a
|
|
Packit |
d27c7e |
very simple form of style-sheet to an XML instance by using ``before''
|
|
Packit |
d27c7e |
and ``after'' strings that are output before and after the contents of
|
|
Packit |
d27c7e |
elements.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">XML::PatAct::PatternTempl, XML::PatAct::ActionTempl</font>
|
|
Packit |
d27c7e |
<font size="2"> BETA</font>
|
|
Packit |
d27c7e |
PatternTempl and ActionTempl are template files that pattern/action
|
|
Packit |
d27c7e |
module writers can copy to create new modules. See Creating PatAct
|
|
Packit |
d27c7e |
Modules for more information.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="5" face="Helvetica,Arial">Documents</font>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">PerlSAX</font>
|
|
Packit |
d27c7e |
This document defines a Perl binding to SAX 1.0. PerlSAX-based parser
|
|
Packit |
d27c7e |
modules implement and possibly extend the interface described in
|
|
Packit |
d27c7e |
PerlSAX.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">Using PerlSAX</font>
|
|
Packit |
d27c7e |
UsingPerlSAX is a brief introduction to PerlSAX using the
|
|
Packit |
d27c7e |
XML::Parser::PerlSAX module.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">Using PatAct Modules</font>
|
|
Packit |
d27c7e |
Describes how to use pattern/action modules to transform XML
|
|
Packit |
d27c7e |
instances.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">Creating PatAct Modules</font>
|
|
Packit |
d27c7e |
A document for module writers who are writing new pattern/ action
|
|
Packit |
d27c7e |
modules.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="4" face="Helvetica,Arial">modules.xml</font>
|
|
Packit |
d27c7e |
modules.xml contains a listing of all Perl XML packages and their
|
|
Packit |
d27c7e |
public modules categorized by several topics.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="5" face="Helvetica,Arial">News</font>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<FONT SIZE=4 face="Helvetica,Arial">
|
|
Packit |
d27c7e |
HREF="http://bitsko.slc.ut.us/libxml-perl/">libxml-perl-0.07</FONT>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size=2>February 22, 2000</font>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-doc/index.html: libxml-perl site index
|
|
Packit |
d27c7e |
-doc/mirror.sh: creates a libxml-perl mirror site
|
|
Packit |
d27c7e |
-Fixes:
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-all modules: release script didn't
|
|
Packit |
d27c7e |
insert version numbers in Perl modules. Reported by
|
|
Packit |
d27c7e |
href="mailto:enno@att.com">Enno Derksen
|
|
Packit |
d27c7e |
-doc/modules.xml: well-formedness errors. Reported by KangChan Lee
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<FONT SIZE=4 face="Helvetica,Arial">
|
|
Packit |
d27c7e |
HREF="http://bitsko.slc.ut.us/libxml-perl/">libxml-perl-0.06</FONT>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size=2>February 4, 2000</font>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-all modules: add $VERSION. Suggested
|
|
Packit |
d27c7e |
by Michael Koehne
|
|
Packit |
d27c7e |
-XML::Parser::PerlSAX: add
|
|
Packit |
d27c7e |
UseAttributeOrder option and AttributeOrder and Defaulted properties
|
|
Packit |
d27c7e |
to start_element() handler. Suggested by
|
|
Packit |
d27c7e |
href="mailto:enno@att.com">Enno Derksen
|
|
Packit |
d27c7e |
-XML::Parser::PerlSAX: add start_cdata,
|
|
Packit |
d27c7e |
end_cdata, and entity_reference events
|
|
Packit |
d27c7e |
-XML::PatAct::Amsterdam: added Output
|
|
Packit |
d27c7e |
and AsString options, added support for replacing attributes
|
|
Packit |
d27c7e |
-Data::Grove: add a
|
|
Packit |
d27c7e |
Data::Grove::Characters class to act as a default grove object for
|
|
Packit |
d27c7e |
containing characters.
|
|
Packit |
d27c7e |
-Fixes:
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-XML::PatAct::ToObjects: removed
|
|
Packit |
d27c7e |
leftover debugging statement
|
|
Packit |
d27c7e |
-XML::ESISParser: report record end as
|
|
Packit |
d27c7e |
characters if no record_end() handler
|
|
Packit |
d27c7e |
-XML::Parser::PerlSAX: For attribute
|
|
Packit |
d27c7e |
list declarations, now correctly calls the attlist_decl() method and
|
|
Packit |
d27c7e |
passes the ElementName property, it used to call entity_decl() passing
|
|
Packit |
d27c7e |
EntityName. Reported by Enno
|
|
Packit |
d27c7e |
Derksen and Colin
|
|
Packit |
d27c7e |
Muller
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<FONT SIZE=4 face="Helvetica,Arial">
|
|
Packit |
d27c7e |
HREF="http://bitsko.slc.ut.us/libxml-perl/">libxml-perl-0.05</FONT>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size=2>August 16, 1999</font>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-Major update to PerlSAX specification
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-Added an introduction
|
|
Packit |
d27c7e |
-Added a ``Deviations from the Java version'' section
|
|
Packit |
d27c7e |
-Re-added the `<tt>set_document_locator()</tt>' handler method
|
|
Packit |
d27c7e |
-Added arguments to method synopses
|
|
Packit |
d27c7e |
-Attributed most of the content to the SAX 1.0 JavaDoc
|
|
Packit |
d27c7e |
-Minor typos
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-XML::Handler::XMLWriter: a new PerlSAX handler for writing readable XML (in contrast to Canonical XML)
|
|
Packit |
d27c7e |
-XML::Handler::Subs: a new PerlSAX handler base class for calling user-defined subs
|
|
Packit |
d27c7e |
-XML::PatAct::ToObjects: add <tt>CopyAttributes</tt> option, add <tt>-grove-contents</tt> action
|
|
Packit |
d27c7e |
-All PatAct modules can now take parameters as either a list of key, value pairs or a hash
|
|
Packit |
d27c7e |
-Fixes:
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-XML::ESISParser wasn't testing handlers for what methods they support
|
|
Packit |
d27c7e |
-XML::Parser::PerlSAX wasn't forwarding XML::Parser Element events
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<FONT SIZE=4 face="Helvetica,Arial">
|
|
Packit |
d27c7e |
HREF="http://bitsko.slc.ut.us/libxml-perl/">libxml-perl-0.04</FONT>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size=2>August 11, 1999</font>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-Added pattern/action modules for name matching, converting to objects, and applying simple styles -- XML::PatAct::MatchName, XML::PatAct::ToObjects, and XML::PatAct::Amsterdam.
|
|
Packit |
d27c7e |
-Added ``Using PatAct Modules'' and ``Creating PatActModules'' docs.
|
|
Packit |
d27c7e |
-XML::Parser::PerlSAX and XML::ESISParser were not passing a hash for `<tt>start_document()</tt>' and `<tt>end_document()</tt>' per spec.
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<FONT SIZE=4 face="Helvetica,Arial">
|
|
Packit |
d27c7e |
HREF="http://bitsko.slc.ut.us/libxml-perl/">libxml-perl-0.03</FONT>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size=2>May 26, 1999</font>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-added XML::Handler::CanonXMLWriter and test
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<FONT SIZE=4 face="Helvetica,Arial">
|
|
Packit |
d27c7e |
HREF="http://bitsko.slc.ut.us/libxml-perl/">libxml-perl-0.02</FONT>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size=2>May 24, 1999</font>
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
-renamed package from `libxml' to `libxml-perl'
|
|
Packit |
d27c7e |
-added doc/modules.xml
|
|
Packit |
d27c7e |
-added doc/UsingPerlSAX.pod and example files
|
|
Packit |
d27c7e |
-moved PerlSAX.pod and interface-style.pod to `doc/'
|
|
Packit |
d27c7e |
-renamed Data::Grove::Tied to Data::Grove::Parent
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
<font size="5" face="Helvetica,Arial">Contributors</font>
|
|
Packit |
d27c7e |
The following have shared their code, documents, comments, and/or suggestions for libxml-perl:
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
Clark Cooper
|
|
Packit |
d27c7e |
Eduard (Enno) Derksen
|
|
Packit |
d27c7e |
Michael Koehne
|
|
Packit |
d27c7e |
KangChan Lee
|
|
Packit |
d27c7e |
Ken MacLeod
|
|
Packit |
d27c7e |
Colin Muller
|
|
Packit |
d27c7e |
Eric Prud'hommeaux
|
|
Packit |
d27c7e |
Larry Wall
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
|
|
Packit |
d27c7e |
</BODY>
|