rpms/perl-XML-DOM
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
XML::DOM - A perl module for building DOM Level 1 compliant document structures https://www.cpan.org/
5 Commits 1 Branch 4 Tags 40 KiB
RPM Spec 100%
main
Go to file
Sdk Build System 0f5dbfa773 rebuilt with perl 5.36.0 [release 1.46-2mamba;Tue Apr 18 2023]
2024-01-06 09:53:28 +01:00
perl-XML-DOM.spec rebuilt with perl 5.36.0 [release 1.46-2mamba;Tue Apr 18 2023] 2024-01-06 09:53:28 +01:00
README.md perl 5.16 mass rebuild [release 1.44-4mamba;Tue Nov 13 2012] 2024-01-06 09:53:28 +01:00

README.md

perl-XML-DOM

This module extends the XML::Parser module by Clark Cooper. The XML::Parser module is built on top of XML::Parser::Expat, which is a lower level interface to James Clark's expat library.

XML::DOM::Parser is derived from XML::Parser. It parses XML strings or files and builds a data structure that conforms to the API of the Document Object Model as described at http://www.w3.org/TR/REC-DOM-Level-1. See the XML::Parser manpage for other available features of the XML::DOM::Parser class. Note that the 'Style' property should not be used (it is set internally.)

The XML::Parser NoExpand option is more or less supported, in that it will generate EntityReference objects whenever an entity reference is encountered in character data. I'm not sure how useful this is. Any comments are welcome.

As described in the synopsis, when you create an XML::DOM::Parser object, the parse and parsefile methods create an XML::DOM::Document object from the specified input. This Document object can then be examined, modified and written back out to a file or converted to a string.

When using XML::DOM with XML::Parser version 2.19 and up, setting the XML::DOM::Parser option KeepCDATA to 1 will store CDATASections in CDATASection nodes, instead of converting them to Text nodes. Subsequent CDATASection nodes will be merged into one. Let me know if this is a problem.

When using XML::Parser 2.27 and above, you can suppress expansion of parameter entity references (e.g. %pent;) in the DTD, by setting ParseParamEnt to 1 and ExpandParamEnt to 0. See Hidden Nodes for details.

A Document has a tree structure consisting of Node objects. A Node may contain other nodes, depending on its type. A Document may have Element, Text, Comment, and CDATASection nodes. Element nodes may have Attr, Element, Text, Comment, and CDATASection nodes. The other nodes may not have any child nodes.

This module adds several node types that are not part of the DOM spec (yet.) These are: ElementDecl (for declarations), AttlistDecl (for declarations), XMLDecl (for declarations) and AttDef (for attribute definitions in an AttlistDecl.)