/usr/share/doc/libxml-libxml-perl/examples/test.html is in libxml-libxml-perl 1.89+dfsg-1.
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 171 172 173 174 175 176 177 178 179 180 181 182 | <HTML>
<HEAD>
<TITLE>XML::LibXML::Document - DOM Document Class</TITLE>
<LINK REV="made" HREF="mailto:root@updates.mandrakesoft.com">
</HEAD>
<BODY>
<!-- INDEX BEGIN -->
<UL>
<LI><A HREF="#NAME">NAME</A>
<LI><A HREF="#SYNOPSIS">SYNOPSIS</A>
<LI><A HREF="#DESCRIPTION">DESCRIPTION</A>
<UL>
<LI><A HREF="#Methods">Methods</A>
</UL>
<LI><A HREF="#SEE_ALSO">SEE ALSO</A>
<LI><A HREF="#VERSION">VERSION</A>
</UL>
<!-- INDEX END -->
<HR>
<P>
<H1><A NAME="NAME">NAME</A></H1>
<P>
XML::LibXML::Document - DOM Document Class
<P>
<HR>
<H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1>
<P>
<PRE> use XML::LibXML::Document;
</PRE>
<P>
<PRE> $dom = XML::LibXML::Document->new( $version, $encoding );
$dom = XML::LibXML::Document->createDocument( $version, $encoding );
$strEncoding = $doc->getEncoding();
$strVersion = $doc->getVersion();
$docstring = $dom->toString([$format]);
$bool = $dom->is_valid();
$root = $dom->getDocumentElement($name, $namespace );
$dom->setDocumentElement( $root );
$element = $dom->createElement( $nodename );
$element = $dom->createElementNS( $namespaceURI, $qname );
$text = $dom->createTextNode( $content_text );
$comment = $dom->createComment( $comment_text );
$attrnode = $doc->createAttribute($name [,$value]);
$attrnode = $doc->createAttributeNS( namespaceURI, $name [,$value] );
$cdata = $dom->create( $cdata_content );
$document->importNode( $node [, $move] );
</PRE>
<P>
<HR>
<H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>
<P>
The Document Class is the result of a parsing process. But sometimes it is
necessary to create a Document from scratch. The DOM Document Class
provides functions that are conform to the DOM Core naming style. It
inherits all functions from <EM>XML::LibXML::Node</EM> as specified in DOM Level2. This enables to access the nodes beside the
root element on document level - a <EM>DTD</EM> for example. The support for these nodes is limited at the moment, so I
would recommend, not to use <EM>node</EM> functions on <EM>documents</EM>. It is suggested that one should always create a node not bound to any
document. There is no need of really including the node to the document,
but once the node is bound to a document, it is quite safe that all strings
have the correct encoding. If an unbound textnode with an iso encoded
string is created (e.g. with $CLASS->new()), the <EM>toString</EM> function may not return the expected result. This seems like a limitation
as long UTF8 encoding is assured. If iso encoded strings come into play it
is much safer to use the node creation functions of <STRONG>XML::LibXML::Document</STRONG>.
<P>
<HR>
<H2><A NAME="Methods">Methods</A></H2>
<DL>
<DT><STRONG><A NAME="item_new">new</A></STRONG><DD>
<P>
alias for <CODE>createDocument()</CODE>
<DT><STRONG><A NAME="item_createDocument">createDocument</A></STRONG><DD>
<P>
The constructor for the document class. As Parameter it takes the version
string and (optionally) the ecoding string. Simply calling <STRONG>createDocument</STRONG> will create the document:
<P>
<PRE>
<?xml version="your version" encoding="your encoding"?>
</PRE>
<P>
Both parameter are optional. The default value for <STRONG>$version</STRONG> is <EM>1.0</EM> , of course. If the <STRONG>$encoding</STRONG> parameter is not set, the encoding will be left unset, which means UTF8 is
implied (and set). The call of <STRONG>createDocument</STRONG> without any parameter will result the following code:
<P>
<PRE>
<?xml version="1.0"?>
</PRE>
<DT><STRONG><A NAME="item_getEncoding">getEncoding</A></STRONG><DD>
<P>
returns the encoding string of the document
<DT><STRONG><A NAME="item_getVersion">getVersion</A></STRONG><DD>
<P>
returns the version string of the document
<DT><STRONG><A NAME="item_toString">toString</A></STRONG><DD>
<P>
<STRONG>toString</STRONG> is a deparsing function, so the DOM Tree can be translated into a string,
ready for output. The optional <STRONG>$format</STRONG> parameter sets the indenting of the output. This parameter is expected to
be an <EM>integer</EM> value, that specifies the number of linebreaks for each node. For more
information about the formatted output check the documentation of <EM>xmlDocDumpFormatMemory</EM> in <EM>libxml2/tree.h</EM> .
<DT><STRONG><A NAME="item_is_valid">is_valid</A></STRONG><DD>
<P>
Returns either TRUE or FALSE depending on the DOM Tree is a valid Document
or not.
<DT><STRONG><A NAME="item_getDocumentElement">getDocumentElement</A></STRONG><DD>
<P>
Returns the root element of the Document. A document can have just one root
element to contain the documents data.
<DT><STRONG><A NAME="item_setDocumentElement">setDocumentElement</A></STRONG><DD>
<P>
This function enables you to set the root element for a document. The
function supports the import of a node from a different document tree.
<DT><STRONG><A NAME="item_createElement">createElement</A></STRONG><DD>
<P>
This function creates a new Element Node bound to the DOM with the name <EM>$nodename</EM> .
<DT><STRONG><A NAME="item_createElementNS">createElementNS</A></STRONG><DD>
<P>
This function creates a new Element Node bound to the DOM with the name <EM>$nodename</EM> and placed in the given namespace.
<DT><STRONG><A NAME="item_createTextNode">createTextNode</A></STRONG><DD>
<P>
As an equivalent of <STRONG>createElement</STRONG> , but it creates a <STRONG>Text Node</STRONG> bound to the DOM.
<DT><STRONG><A NAME="item_createComment">createComment</A></STRONG><DD>
<P>
As an equivalent of <STRONG>createElement</STRONG> , but it creates a <STRONG>Comment Node</STRONG> bound to the DOM.
<DT><STRONG><A NAME="item_createAttribute">createAttribute</A></STRONG><DD>
<P>
Creates a new Attribute node. This function is rather useless at the
moment, since there is no setAttributeNode function defined in <EM>XML::LibXML::Element</EM> , yet.
<DT><STRONG><A NAME="item_createAttributeNS">createAttributeNS</A></STRONG><DD>
<P>
Creates an Attribute bound to a namespace.
<DT><STRONG><A NAME="item_createCDATASection">createCDATASection</A></STRONG><DD>
<P>
Similar to createTextNode and createComment, this function creates a
CDataSection bound to the current DOM.
<DT><STRONG><A NAME="item_importNode">importNode</A></STRONG><DD>
<P>
If a node is not part of a document, it can be imported to another
document. As specified in DOM Level 2 Specification the Node will not be
altered or removed from its original document by default. ( <EM>$node-</EM><CODE>cloneNode(1)></CODE> will get called implicitly). Sometimes it is
nessecary to <EM>move</EM> a node between documents. In such a case the node will not be copied, but
removed from the original document.
</DL>
<P>
<HR>
<H1><A NAME="SEE_ALSO">SEE ALSO</A></H1>
<P>
XML::LibXML, XML::LibXML::Element, XML::LibXML::Text, XML::LibXML::Attr,
XML::LibXML::Comment
<P>
<HR>
<H1><A NAME="VERSION">VERSION</A></H1>
<P>
0.90_a
</BODY>
</HTML>
|