Front page | perl.perl5.porters |
Postings from December 2011
On Fri Nov 18 12:04:31 2011, rwstauner wrote:
>
> This appears to have been changed by 5.12(.3):
>
> > Links to an absolute URL. For example, "L<http://www.perl.org/>" or
> "L<The Perl Home Page|http://www.perl.org/>".
>
The problem I have with the second version above is that it doesn't
produce a link in HTML.
I am attaching (a) a small .pod file; (b) the same file supplied as
argument to 'pod2text'; (c) the same file supplied as argument to
'pod2html --infile=104008.pod --outfile=104008.html --noindex'.
('pod2man' produced results similar to 'pod2text'.)
Note that I got a meaningful result in 104008.txt, but I did not get a
clickable link in 104008.html. In the .html case, I got this warning:
###
/usr/local/bin/pod2html: 104008.pod: cannot resolve L<The Perl Home
Page|http://www.perl.org/> in paragraph 5.
###
> However, the current perlpodspec still says:
>
> > Authors wanting to link to a particular (absolute) URL, must do so
> only with "L<scheme:...>" codes (like
> > L<http://www.perl.org>), and must not attempt "L<Some Site
> Name|scheme:...>" codes. This restriction avoids many problems
> > in parsing and rendering L<...> codes.
Can you identify the file this excerpt comes from?
Thread Next