Mailing List Archive

Bug in pod2html ?
According to perlpod, having a paragraph indented means don't touch
it: output verbatim. With pod2html that comes with 5.001m, if you
have only two newlines (i.e. one blank line) after the '=head1' text,
the paragraph is not verbatim. If you put tree newlines there
(i.e. two blank lines) the paragraph is.

Is this a bug or is it that perlpod is outdated ?

Here is a pod that illustrate that:

=head1 The following paragraph should appear verbatim [and it does]


#!/usr/local/bin/perl
$foo = 1;
print "foo => $foo\n";


=head1 The following paragraph should also appear verbatim [but it doesn't]

#!/usr/local/bin/perl
$foo = 1;
print "foo => $foo\n";

Marc Paquette | Marc.Paquette@Softimage.COM
Administrateur de Systemes / Sysadmin | Softimage Inc
tel: (514) 845-1636 ext. 3426 | 3510 Boulevard St-Laurent
fax: (514) 845-5676 | Montreal (Quebec) H2X 2V2
Re: Bug in pod2html ? [ In reply to ]
On Tue, 22 Aug 1995, Marc Paquette wrote:

>
> According to perlpod, having a paragraph indented means don't touch
> it: output verbatim. With pod2html that comes with 5.001m, if you
> have only two newlines (i.e. one blank line) after the '=head1' text,
> the paragraph is not verbatim. If you put tree newlines there
> (i.e. two blank lines) the paragraph is.
>
> Is this a bug or is it that perlpod is outdated ?
>
> Here is a pod that illustrate that:
>
> =head1 The following paragraph should appear verbatim [and it does]
>
>
> #!/usr/local/bin/perl
> $foo = 1;
> print "foo => $foo\n";
>
>
> =head1 The following paragraph should also appear verbatim [but it doesn't]
>
> #!/usr/local/bin/perl
> $foo = 1;
> print "foo => $foo\n";

In theory, both should be equivalent. I'm not the maintainer of the
current pod2html, so I can't easily what it was designed to, but according
to POD spec those two should be equivalent (assuming no spaces managed to
get onto those blank lines.)

> Marc Paquette | Marc.Paquette@Softimage.COM
> Administrateur de Systemes / Sysadmin | Softimage Inc
> tel: (514) 845-1636 ext. 3426 | 3510 Boulevard St-Laurent
> fax: (514) 845-5676 | Montreal (Quebec) H2X 2V2
>

--
Kenneth Albanowski (kjahds@kjahds.com, CIS: 70705,126)