develooper Front page | perl.perl5.porters | Postings from November 1999

A bug in Pod::Html

From:
j.vavruska
Date:
November 10, 1999 08:39
Subject:
A bug in Pod::Html
Message ID:
199911101638.RAA27414@relay.globe.cz
Hello,

Sorry to disturb you if the bug I am going to describe was already fixed. I found your address in Pod::Html that came with ActiveState Perl build 522.

The same bug seems to be in perl 5.005_03 I have on my Linux box at home, but now I am in the office with Win NT.

When I use a link without section, e.g. \" L<Designer Guide|Designer> \", pod2html reports:

 cannot resolve L<Designer Guide|Designer> in paragraph  ... : no such page \'Designer Guide|Designer\' 

In sub Pod::Html::process_L, line 1490 is:

	    ($page, $section) = ($str, \"\");

while it should be

	    ($page, $section) = ($_, \"\");

(sorry, I have no diff on my NT machine; I am not the administrator here).

EXPLANATION:
$str holds the parameters inside L< ... > tag.
Inside the function process_L, the value is assigned to $s1. This variable ($s1) is manipulated inside \"for ($s1) { ... } \", maybe to simplify syntax of regex substitutions.

The text to be displayed (L<text to display|page/section>) is separated from page/section and processed correctly IF both the page AND section are present in L<> tag. If /section is missing, incorrect assignment to $page is made at line 1490.

The problem was fixed by replacing the original parameters variable, $str, by $_ which contains the expected content after all manipulations.

I apologize if this was already fixed. I have this problem all the time I want to create html docs from POD, both on Linux and NT.

Best regards,

--
Jindra Vavruska (OK1FOU)
j.vavruska@post.cz

 Pro kazdeho e-mailova schranka zdarma na:
 *** http://POST.CZ 





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