/usr/share/perl5/XML/DOM-ecmascript.pod is in libxml-grove-perl 0.46alpha-12.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 | =head1 NAME
DOM-ecmascript - XML::Grove and ECMA Script Language Binding
=head1 XML::Grove and DOM Level One
XML::Grove is similar in concept to the ECMA Script Language Binding
to DOM Level 1 Core (Appendix E of the DOM Recommendation).
L<http://www.w3.org/TR/REC-DOM-Level-1/
ecma-script-language-binding.html|http://www.w3.org/TR/REC-DOM-Level-1/ecma-script-language-binding.html>
The ECMA Script Language Binding presents DOM properties as ECMA
Script object properties. The same is true for XML::Grove, XML::Grove
presents DOM properties as Perl blessed hashes.
The biggest difference between the ECMA Script Language Binding and
XML::Grove is that XML::Grove uses a Perl hash for nodes, Perl arrays
for NodeLists, Perl hashes for NamedNodeLists so those object classes
don't exist in XML::Grove. Because those classes don't exist, you use
ordinary Perl syntax for manipulating the DOM properties (lists and
named node lists) instead of methods like `C<nextSibling()>' or
`C<replaceChild()>'. Element attributes in XML::Grove are stored in
Perl hashes; attribute types are available through the document
object.
Another difference is that XML::Grove attempts to marry the PerlSAX
and DOM naming so that less (no?) name-changing occurs between using
PerlSAX interfaces and filters and DOM modules. Where conflicts
occur, the PerlSAX naming is used.
XML::Grove uses a blessed hash for nodes, so the node type is
available using Perl's `C<ref()>' instead of using a `C<nodeType()>'
method and all class names are prefixed with `C<XML::Grove::>'.
The following object descriptions are the most basic and common
provided by many PerlSAX parsers. PerlSAX parsers often provide
additional properties or objects, refer to your PerlSAX parser
documentation for details.
=head1 Document Object Model Level 1 Core
=head2 Object XML::Grove::Document
=over 12
=item Contents
The children of this object. This property is an array.
=item Entities
The entities declared in this document. This property is a hash of
XML::Grove::Entity objects keyed by entity name.
=item Notations
The notations declared in this document. This property is a hash of
XML::Grove::Notation objects keyed by notation name.
=back
=head2 Object XML::Grove::Element
=over 12
=item Name
The tag type name for this element. This property is a string.
=item Attributes
The attributes for this element. This property is a hash and it's
hash values are strings (or arrays with some grove builders).
=item Contents
The children of this object. This property is an array of XML::Grove
objects.
=back
=head2 Object XML::Grove::Characters
=over 12
=item Data
The text of the character data. This property is a string.
=back
=head2 Object XML::Grove::Comment
=over 12
=item Data
The text of the character data. This property is a string.
=back
=head2 Object XML::Grove::CData
The C<CData> object is called a C<CDATASection> in DOM.
=over 12
=item Data
The text of the character data. This property is a string.
=back
=head2 Object XML::Grove::Notation
=over 12
=item Name
The name of this notation. This property is a string.
=item SystemId
The system identifier of this notation. This property is a string.
=item PublicId
The public identifier of this notation. This property is a string.
=back
=head2 Object XML::Grove::Entity
=over 12
=item Name
The name of this entity. This property is a string.
=item SystemId
The system identifier of this notation. This property is a string.
=item PublicId
The public identifier of this notation. This property is a string.
=item Notation
The notation declared for this entity. This property is either the
name of the notation as a string or an C<XML::Grove::Notation> object.
=back
=head2 Object XML::Grove::PI
The C<PI> object is called a C<ProcessingInstruction> in DOM.
=over 12
=item Target
The target of the processing instruction. This property is a string.
=item Data
The text of the processing instruction. This property is a string.
=back
|