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

Re: L<> links in pod (was Re: 5.8.2 perldelta)

From:
Autrijus Tang
Date:
November 1, 2003 03:48
Subject:
Re: L<> links in pod (was Re: 5.8.2 perldelta)
Message ID:
20031101023016.GB650@aut.dyndns.org
On Fri, Oct 31, 2003 at 10:03:45PM +0100, Rafael Garcia-Suarez wrote:
> Sean M. Burke wrote:
> > If I may critique podchecker for a minute:  BULLSHIT!
> Well actually, if we reformulate F<...> as "this is an URI", pod2html's
> habit to turn F<http://...> into links makes sense retroactively.

That contradicts existing usage.  For example, one often sees:

    This module will search for a F<foo.conf> in your C<$ENV{PATH}>,
    parse it, and write the parse tree as F<foo.out> in an temporary
    directory as an intermediate cache.

Neither "foo.conf" nor "foo.out" is a URI in that paragraph.  They are
not relative to the POD's current directory, and does not serve well as
anchors of anything.

So I'd prefer to keep the documented perlpodspec/perlpod interpretation.

Thanks
,/Autrijus/



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