develooper Front page | perl.pod-people | Postings from April 2012

pod2html in perl-5.15.9 recognizes POD markup in verbatim sections

Thread Next
From:
Gisle Aas
Date:
April 25, 2012 02:21
Subject:
pod2html in perl-5.15.9 recognizes POD markup in verbatim sections
Message ID:
D99350E3-E452-429E-8BAA-D5562786FF05@activestate.com
pod2html in perl-5.15.9 uses Pod::Simple::XHTML to do its work; and Pod::Simple::XHTML is different than other POD formatters in that it enables 'codes_in_verbatim' feature of Pod::Simple.  This makes POD like this:

> =head1 TEXT
> 
>   $a++ B<if> $a < 10;
> 
> more text here.

turn into (you get a bolded if-keyword):

> <h1 id="TEXT">TEXT</h1>
> 
> <pre><code>  $a++ <b>if</b> $a &lt; 10;</code></pre>
> 
> <p>more text here.</p>

while pod2text just outputs:

> TEXT
>       $a++ B<if> $a < 10;
> 
>     more text here.

I don't like this inconsistency.  I believe this "feature" should simply be turned off.  This is a patch to do that:

   https://github.com/gisle/pod-simple/commit/846241382485e039ad3802af81c8c1e87afe1ac9

Any objections?

--Gisle


Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About