Bug#874063: [PATCH] Document.pod minor cleanup including rendered column alignment
Dan Jacobson
jidanni at jidanni.org
Sat Sep 2 15:02:11 UTC 2017
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">
More information about the pkg-perl-maintainers
mailing list