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