Package: libxml-libxml-perl Version: 2.0128+dfsg-3 Severity: wishlist File: /usr/lib/x86_64-linux-gnu/perl5/5.26/XML/LibXML/Document.pod
--- /usr/lib/x86_64-linux-gnu/perl5/5.26/XML/LibXML/Document.pod 2016-07-24 17:05:45.000000000 +0800 +++ /tmp/Document.pod 2017-09-02 21:47:47.571038913 +0800 @@ -243,8 +243,6 @@ returns the XML as a byte string in the original encoding of the document (see the actualEncoding() method)! This means you can simply do: - - open my $out_fh, '>', $file; print {$out_fh} $doc->toString; @@ -345,7 +343,6 @@ You may also pass in a L<<<<<< XML::LibXML::Dtd >>>>>> object, to validate against an external DTD: - if (!$dom->is_valid($dtd)) { warn("document is not valid!"); } @@ -359,7 +356,7 @@ valid it will throw an exception containing the error. This allows you much better error reporting than simply is_valid or not. -Again, you may pass in a DTD object +Again, you may pass in a DTD object. =item documentElement @@ -462,10 +459,9 @@ not be expanded to a real entity reference unless it is a predefined entity - my $string = "&foo;"; - $some_element->appendText( $string ); - print $some_element->textContent; # prints "&foo;" + $some_element->appendText( $string ); + print $some_element->textContent; # prints "&foo;" =item createInternalSubset @@ -477,29 +473,25 @@ need to add the created node explicitly to the document. - my $document = XML::LibXML::Document->new(); - my $dtd = $document->createInternalSubset( "foo", undef, "foo.dtd" ); + my $dtd = $document->createInternalSubset( "foo", undef, "foo.dtd" ); will result in the following XML document: - <?xml version="1.0"?> - <!DOCTYPE foo SYSTEM "foo.dtd"> + <!DOCTYPE foo SYSTEM "foo.dtd"> By setting the public parameter it is possible to set PUBLIC DTDs to a given document. So - my $document = XML::LibXML::Document->new(); my $dtd = $document->createInternalSubset( "foo", "-//FOO//DTD FOO 0.1//EN", undef ); will cause the following declaration to be created on the document: - <?xml version="1.0"?> <!DOCTYPE foo PUBLIC "-//FOO//DTD FOO 0.1//EN">