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

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

Thread Previous | Thread Next
From:
Nicholas Clark
Date:
October 30, 2003 15:12
Subject:
L<> links in pod (was Re: 5.8.2 perldelta)
Message ID:
20031030231136.GK6287@plum.flirble.org
On Thu, Oct 30, 2003 at 12:37:36PM +0100, Petras Kudaras wrote:
> Autrijus Tang wrote:
> 
> >On Thu, Oct 30, 2003 at 12:23:08PM +0100, Petras Kudaras wrote:
> >
> >>-the Perl 5 bugs at http://bugs.perl.org/
> >>+the Perl 5 bugs at F<http://bugs.perl.org/>
> >>
> >
> >Sorry for being pedantic, but URLs in POD documents use
> >L<>, not F<>.  perlpod.pod says:
> >
> 
> OK, it is just that other URLs in the perldelta were done with F<>,
> so I just followed that. I guess one needs to change all F<>s
> referring to URL in the whole perldelta. Here is a patch then:

I've not committed this yet. I've been in the habit of running pod/podchecker

*** WARNING: node 'http://bugs.perl.org/' contains non-escaped | or / at line 143 in file pod/perldelta.pod
*** WARNING: node 'http://www.perl.com/' contains non-escaped | or / at line 144 in file pod/perldelta.pod
*** WARNING: node 'http://bugs.perl.org/' contains non-escaped | or / at line 151 in file pod/perldelta.pod
pod/perldelta.pod pod syntax OK.


(for this:)
> --- perldelta582.pod.orig       Thu Oct 30 12:21:43 2003
> +++ perldelta582.pod    Thu Oct 30 12:39:44 2003
> @@ -140,15 +140,15 @@
> 
> If you find what you think is a bug, you might check the articles
> recently posted to the comp.lang.perl.misc newsgroup and the perl
> -bug database at F<http://bugs.perl.org/>.  There may also be
> -information at F<http://www.perl.com/>, the Perl Home Page.
> +bug database at L<http://bugs.perl.org/>.  There may also be
> +information at L<http://www.perl.com/>, the Perl Home Page.
> 
> If you believe you have an unreported bug, please run the B<perlbug>
> program included with your release.  Be sure to trim your bug down
> to a tiny but sufficient test case.  Your bug report, along with the
> output of C<perl -V>, will be sent off to perlbug@perl.org to be
> analysed by the Perl porting team.  You can browse and search
> -the Perl 5 bugs at http://bugs.perl.org/
> +the Perl 5 bugs at L<http://bugs.perl.org/>.
> 
> =head1 SEE ALSO


What's the "correct" way to do links in POD such that podchecker is happy?

Nicholas Clark

Thread Previous | 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