summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Williamson <khw@cpan.org>2017-03-30 22:10:46 -0600
committerKarl Williamson <khw@cpan.org>2017-04-05 11:28:08 -0600
commit4b05bc8ea5a106c203e7154f3cbae72e133c9c80 (patch)
tree97252ee73ea15fb216e5dced1f914bf294883199
parent5fc389563644287b3e5f448616ce62dd0ce4e7a6 (diff)
downloadperl-4b05bc8ea5a106c203e7154f3cbae72e133c9c80.tar.gz
pods: Add L<> for links missing them; a couple nits
-rw-r--r--Porting/how_to_write_a_perldelta.pod2
-rw-r--r--Porting/pumpkin.pod4
-rw-r--r--Porting/release_managers_guide.pod16
-rw-r--r--README.aix2
-rw-r--r--README.freebsd2
-rw-r--r--README.hurd2
-rw-r--r--README.jp4
-rw-r--r--README.os3902
-rw-r--r--pod/perlembed.pod4
-rw-r--r--pod/perlgit.pod4
-rw-r--r--pod/perlhack.pod6
-rw-r--r--pod/perlhacktips.pod6
-rw-r--r--pod/perlintro.pod2
-rw-r--r--pod/perlmodinstall.pod34
-rw-r--r--pod/perlmodstyle.pod2
-rw-r--r--pod/perlnewmod.pod4
-rw-r--r--pod/perlop.pod4
-rw-r--r--pod/perlperf.pod11
-rw-r--r--pod/perlpodstyle.pod2
-rw-r--r--pod/perlre.pod3
-rw-r--r--pod/perlreftut.pod2
-rw-r--r--pod/perlreref.pod2
-rw-r--r--pod/perlthrtut.pod2
-rw-r--r--t/porting/known_pod_issues.dat4
24 files changed, 67 insertions, 59 deletions
diff --git a/Porting/how_to_write_a_perldelta.pod b/Porting/how_to_write_a_perldelta.pod
index effd16696d..cc3bbe1986 100644
--- a/Porting/how_to_write_a_perldelta.pod
+++ b/Porting/how_to_write_a_perldelta.pod
@@ -51,7 +51,7 @@ C<[rt.cpan.org #43010]>. This mirrors how rt.cpan.org subject lines appear.
=item ActiveState
-C<http://bugs.activestate.com/show_bug.cgi?id=72443>
+C<L<http://bugs.activestate.com/show_bug.cgi?id=72443>>
=item Debian
diff --git a/Porting/pumpkin.pod b/Porting/pumpkin.pod
index 69da88bf9a..a1fe67503b 100644
--- a/Porting/pumpkin.pod
+++ b/Porting/pumpkin.pod
@@ -24,7 +24,7 @@ and all the various auxiliary files that are part of the distribution.
The Comprehensive Perl Archive Network (or CPAN) is the place to go.
There are many mirrors, but the easiest thing to use is probably
-http://www.cpan.org/README.html , which automatically points you to a
+L<http://www.cpan.org/README.html> , which automatically points you to a
mirror site "close" to you.
=head2 Perl5-porters mailing list
@@ -1124,7 +1124,7 @@ and the full tar file, e.g. F<perl5.004_08.tar.gz>.
If you want your patch to appear in the F<src/5.0/unsupported>
directory on CPAN, send e-mail to the CPAN master librarian. (Check
-out http://www.cpan.org/CPAN.html ).
+out L<http://www.cpan.org/CPAN.html> ).
=head1 Help Save the World
diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod
index ffd5b51d09..5c9bf4995f 100644
--- a/Porting/release_managers_guide.pod
+++ b/Porting/release_managers_guide.pod
@@ -173,7 +173,7 @@ which has a F<public_html> directory to share files with.
If you use Dropbox, you can append "raw=1" as a parameter to their usual
sharing link to allow direct download (albeit with redirects).
-=head3 git clone of https://github.com/perlorg/perlweb
+=head3 git clone of L<https://github.com/perlorg/perlweb>
For updating the L<http://dev.perl.org> web pages, either a Github account or
sweet-talking somebody with a Github account into obedience is needed. This
@@ -373,14 +373,14 @@ fix.
=head3 monitor CPAN testers for failures
For any release except a BLEAD-POINT: Examine the relevant analysis report(s)
-at http://analysis.cpantesters.org/beforemaintrelease to see how the impending
-release is performing compared to previous releases with regard to building
-and testing CPAN modules.
+at L<http://analysis.cpantesters.org/beforemaintrelease> to see how the
+impending release is performing compared to previous releases with
+regard to building and testing CPAN modules.
That page accepts a query parameter, C<pair> that takes a pair of
colon-delimited versions to use for comparison. For example:
-http://analysis.cpantesters.org/beforemaintrelease?pair=5.20.2:5.22.0%20RC1
+L<http://analysis.cpantesters.org/beforemaintrelease?pair=5.20.2:5.22.0%20RC1>
=head3 update perldelta
@@ -644,7 +644,7 @@ modules on CPAN. It can use a full, local CPAN mirror and/or fall back
on HTTP::Tiny to fetch package metadata remotely.
(If you'd prefer to have a full CPAN mirror, see
-http://www.cpan.org/misc/cpan-faq.html#How_mirror_CPAN)
+L<http://www.cpan.org/misc/cpan-faq.html#How_mirror_CPAN>)
Then change to your perl checkout, and if necessary,
@@ -739,7 +739,7 @@ formatting, e.g.
$ ./perl -Ilib ext/Pod-Html/bin/pod2html pod/perldelta.pod > \
/tmp/perldelta.html
-Another good HTML preview option is http://search.cpan.org/pod2html
+Another good HTML preview option is L<http://search.cpan.org/pod2html>
If you make changes, be sure to commit them.
@@ -1545,7 +1545,7 @@ will make life easier for the next release manager.
=head1 SOURCE
Based on
-http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/2009-05/msg00608.html,
+L<http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/2009-05/msg00608.html>,
plus a whole bunch of other sources, including private correspondence.
=cut
diff --git a/README.aix b/README.aix
index be2832739b..7e185a9936 100644
--- a/README.aix
+++ b/README.aix
@@ -428,7 +428,7 @@ fill in its choices
Follow the messages ... and you're done.
If you like a more web-like approach, a good start point can be
-http://www14.software.ibm.com/webapp/download/downloadaz.jsp and click
+L<http://www14.software.ibm.com/webapp/download/downloadaz.jsp> and click
"C for AIX", and follow the instructions.
=head2 The usenm option
diff --git a/README.freebsd b/README.freebsd
index 1b290ce7cd..8e62903a88 100644
--- a/README.freebsd
+++ b/README.freebsd
@@ -17,7 +17,7 @@ When perl is configured to use ithreads, it will use re-entrant library calls
in preference to non-re-entrant versions. There is a bug in FreeBSD's
C<readdir_r> function in versions 4.5 and earlier that can cause a SEGV when
reading large directories. A patch for FreeBSD libc is available
-(see http://www.freebsd.org/cgi/query-pr.cgi?pr=misc/30631 )
+(see L<http://www.freebsd.org/cgi/query-pr.cgi?pr=misc/30631> )
which has been integrated into FreeBSD 4.6.
=head2 C<$^X> doesn't always contain a full path in FreeBSD
diff --git a/README.hurd b/README.hurd
index 26fd0ee5dd..8cb0563424 100644
--- a/README.hurd
+++ b/README.hurd
@@ -9,7 +9,7 @@ perlhurd - Perl version 5 on Hurd
=head1 DESCRIPTION
If you want to use Perl on the Hurd, I recommend using the Debian
-GNU/Hurd distribution ( see http://www.debian.org/ ), even if an
+GNU/Hurd distribution ( see L<http://www.debian.org/> ), even if an
official, stable release has not yet been made. The old "gnu-0.2"
binary distribution will most certainly have additional problems.
diff --git a/README.jp b/README.jp
index 2a1fa57939..ac79078a1b 100644
--- a/README.jp
+++ b/README.jp
@@ -57,9 +57,9 @@ Perl 自身は Unicode で動作します。Perl スクリプト内の文字列
=head2 About (jcode.pl|Jcode.pm|JPerl)
-5.8以前の、スクリプトがEUC-JPであればリテラルだけは扱うことができました。また、入出力を扱うモジュールとしてはJcode.pmが( http://openlab.ring.gr.jp/Jcode/ )、perl4用のユーティリティとしてはjcode.plがそれぞれ存在し、日本語の扱えるCGIでよく利用されていることを御存じの方も少なくないかと思われます。ただし、日本語による正規表現をうまく扱うことは不可能でした。
+5.8以前の、スクリプトがEUC-JPであればリテラルだけは扱うことができました。また、入出力を扱うモジュールとしてはJcode.pmが( L<http://openlab.ring.gr.jp/Jcode/> )、perl4用のユーティリティとしてはjcode.plがそれぞれ存在し、日本語の扱えるCGIでよく利用されていることを御存じの方も少なくないかと思われます。ただし、日本語による正規表現をうまく扱うことは不可能でした。
-5.005以前のPerlには、日本語に特化したローカライズ版、Jperlが存在しました( http://homepage2.nifty.com/kipp/perl/jperl/index.html )。また、Mac OS 9.x/Classic用のPerl、MacPerlの日本語版もMacJPerlとして存在してました。( http://habilis.net/macjperl/ ).これらでは文字コードとしてEUC-JPに加えShift_JISもそのまま扱うことができ、また日本語による正規表現を扱うことも可能でした。
+5.005以前のPerlには、日本語に特化したローカライズ版、Jperlが存在しました( L<http://homepage2.nifty.com/kipp/perl/jperl/index.html> )。また、Mac OS 9.x/Classic用のPerl、MacPerlの日本語版もMacJPerlとして存在してました。( L<http://habilis.net/macjperl/> ).これらでは文字コードとしてEUC-JPに加えShift_JISもそのまま扱うことができ、また日本語による正規表現を扱うことも可能でした。
Perl5.8では、これらの機能がすべてPerl本体だけで実現できる上に、日本語のみならず上記114の文字コードをすべて、しかも同時に扱うことができます。さらに、CPANなどから新しい文字コード用のモジュールを入手することも簡単にできるようになっています。
diff --git a/README.os390 b/README.os390
index 0386209f39..8062628aa3 100644
--- a/README.os390
+++ b/README.os390
@@ -29,7 +29,7 @@ running the Configure script for Perl.
The z/OS Unix Tools and Toys list may prove helpful and contains links
to ports of much of the software helpful for building Perl.
-http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html
+L<http://www.ibm.com/servers/eserver/zseries/zos/unix/bpxa1toy.html>
=head2 Unpacking Perl distribution on OS/390
diff --git a/pod/perlembed.pod b/pod/perlembed.pod
index 1c971c32b4..70f8e0d38b 100644
--- a/pod/perlembed.pod
+++ b/pod/perlembed.pod
@@ -161,7 +161,7 @@ you:
If the B<ExtUtils::Embed> module isn't part of your Perl distribution,
you can retrieve it from
-http://www.perl.com/perl/CPAN/modules/by-module/ExtUtils/
+L<http://www.perl.com/perl/CPAN/modules/by-module/ExtUtils/>
(If this documentation came from your Perl distribution, then you're
running 5.004 or better and you already have it.)
@@ -1137,7 +1137,7 @@ Christiansen, Guy Decoux, Hallvard Furuseth, Dov Grobgeld, and Ilya
Zakharevich.
Doug MacEachern has an article on embedding in Volume 1, Issue 4 of
-The Perl Journal ( http://www.tpj.com/ ). Doug is also the developer of the
+The Perl Journal ( L<http://www.tpj.com/> ). Doug is also the developer of the
most widely-used Perl embedding: the mod_perl system
(perl.apache.org), which embeds Perl in the Apache web server.
Oracle, Binary Evolution, ActiveState, and Ben Sugars's nsapi_perl
diff --git a/pod/perlgit.pod b/pod/perlgit.pod
index 9d3edccba9..d05a29d6d7 100644
--- a/pod/perlgit.pod
+++ b/pod/perlgit.pod
@@ -918,11 +918,11 @@ general testing and development. Dromedary syncs the git tree from
camel every few minutes, you should not push there. Both machines also
have a full CPAN mirror in F</srv/CPAN>, please use this. To share files
with the general public, dromedary serves your F<~/public_html/> as
-C<http://users.perl5.git.perl.org/~yourlogin/>
+C<L<http://users.perl5.git.perl.org/~yourlogin/>>
These hosts have fairly strict firewalls to the outside. Outgoing, only
rsync, ssh and git are allowed. For http and ftp, you can use
-http://webproxy:3128 as proxy. Incoming, the firewall tries to detect
+L<http://webproxy:3128> as proxy. Incoming, the firewall tries to detect
attacks and blocks IP addresses with suspicious activity. This
sometimes (but very rarely) has false positives and you might get
blocked. The quickest way to get unblocked is to notify the admins.
diff --git a/pod/perlhack.pod b/pod/perlhack.pod
index c8c6b86d03..4c645a6c41 100644
--- a/pod/perlhack.pod
+++ b/pod/perlhack.pod
@@ -1107,11 +1107,11 @@ wanting to go about Perl development.
=head1 CPAN TESTERS AND PERL SMOKERS
-The CPAN testers ( http://testers.cpan.org/ ) are a group of volunteers
+The CPAN testers ( L<http://testers.cpan.org/> ) are a group of volunteers
who test CPAN modules on a variety of platforms.
-Perl Smokers ( http://www.nntp.perl.org/group/perl.daily-build/ and
-http://www.nntp.perl.org/group/perl.daily-build.reports/ )
+Perl Smokers ( L<http://www.nntp.perl.org/group/perl.daily-build/> and
+L<http://www.nntp.perl.org/group/perl.daily-build.reports/> )
automatically test Perl source releases on platforms with various
configurations.
diff --git a/pod/perlhacktips.pod b/pod/perlhacktips.pod
index 45d42f6ce5..d80c69e3ae 100644
--- a/pod/perlhacktips.pod
+++ b/pod/perlhacktips.pod
@@ -1049,7 +1049,7 @@ diddle with the flags (see above).
=head2 Coverity
-Coverity (http://www.coverity.com/) is a product similar to lint and as
+Coverity (L<http://www.coverity.com/>) is a product similar to lint and as
a testbed for their product they periodically check several open source
projects, and they give out accounts to open source developers to the
defect databases.
@@ -1072,8 +1072,8 @@ cut-and-pasted code changes, all the other spots should probably be
changed, too. Therefore such code should probably be turned into a
subroutine or a macro.
-cpd (http://pmd.sourceforge.net/cpd.html) is part of the pmd project
-(http://pmd.sourceforge.net/). pmd was originally written for static
+cpd (L<http://pmd.sourceforge.net/cpd.html>) is part of the pmd project
+(L<http://pmd.sourceforge.net/>). pmd was originally written for static
analysis of Java code, but later the cpd part of it was extended to
parse also C and C++.
diff --git a/pod/perlintro.pod b/pod/perlintro.pod
index 9559cb1d12..5c168c18e1 100644
--- a/pod/perlintro.pod
+++ b/pod/perlintro.pod
@@ -675,7 +675,7 @@ in using third-party modules, which are documented below.
=head2 Using Perl modules
Perl modules provide a range of features to help you avoid reinventing
-the wheel, and can be downloaded from CPAN ( http://www.cpan.org/ ). A
+the wheel, and can be downloaded from CPAN ( L<http://www.cpan.org/> ). A
number of popular modules are included with the Perl distribution
itself.
diff --git a/pod/perlmodinstall.pod b/pod/perlmodinstall.pod
index 71f6b6cbd2..39c410df30 100644
--- a/pod/perlmodinstall.pod
+++ b/pod/perlmodinstall.pod
@@ -7,10 +7,10 @@ perlmodinstall - Installing CPAN Modules
You can think of a module as the fundamental unit of reusable Perl
code; see L<perlmod> for details. Whenever anyone creates a chunk of
Perl code that they think will be useful to the world, they register
-as a Perl developer at http://www.cpan.org/modules/04pause.html
+as a Perl developer at L<http://www.cpan.org/modules/04pause.html>
so that they can then upload their code to the CPAN. The CPAN is the
Comprehensive Perl Archive Network and can be accessed at
-http://www.cpan.org/ , and searched at http://search.cpan.org/ .
+L<http://www.cpan.org/> , and searched at L<http://search.cpan.org/> .
This documentation is for people who want to download CPAN modules
and install them on their own computer.
@@ -68,14 +68,14 @@ directory) and use this approach.
B<If you're on a Unix or Unix-like system,>
You can use Andreas Koenig's CPAN module
-( http://www.cpan.org/modules/by-module/CPAN )
+( L<http://www.cpan.org/modules/by-module/CPAN> )
to automate the following steps, from DECOMPRESS through INSTALL.
A. DECOMPRESS
Decompress the file with C<gzip -d yourmodule.tar.gz>
-You can get gzip from ftp://prep.ai.mit.edu/pub/gnu/
+You can get gzip from L<ftp://prep.ai.mit.edu/pub/gnu/>
Or, you can combine this step with the next to save disk space:
@@ -128,7 +128,7 @@ steps below.
A. DECOMPRESS
-You can use the shareware Winzip ( http://www.winzip.com ) to
+You can use the shareware Winzip ( L<http://www.winzip.com> ) to
decompress and unpack modules.
B. UNPACK
@@ -138,9 +138,9 @@ If you used WinZip, this was already done for you.
C. BUILD
You'll need the C<nmake> utility, available at
-http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/nmake15.exe
+L<http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/nmake15.exe>
or dmake, available on CPAN.
-http://search.cpan.org/dist/dmake/
+L<http://search.cpan.org/dist/dmake/>
Does the module require compilation (i.e. does it have files that end
in .xs, .c, .h, .y, .cc, .cxx, or .C)? If it does, life is now
@@ -148,7 +148,7 @@ officially tough for you, because you have to compile the module
yourself (no easy feat on Windows). You'll need a compiler such as
Visual C++. Alternatively, you can download a pre-built PPM package
from ActiveState.
-http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/
+L<http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/>
Go into the newly-created directory and type:
@@ -170,7 +170,7 @@ B<If you're using a Macintosh with "Classic" MacOS and MacPerl,>
A. DECOMPRESS
First, make sure you have the latest B<cpan-mac> distribution (
-http://www.cpan.org/authors/id/CNANDOR/ ), which has utilities for
+L<http://www.cpan.org/authors/id/CNANDOR/> ), which has utilities for
doing all of the steps. Read the cpan-mac directions carefully and
install it. If you choose not to use cpan-mac for some reason, there
are alternatives listed here.
@@ -179,15 +179,15 @@ After installing cpan-mac, drop the module archive on the
B<untarzipme> droplet, which will decompress and unpack for you.
B<Or>, you can either use the shareware B<StuffIt Expander> program
-( http://my.smithmicro.com/mac/stuffit/ )
+( L<http://my.smithmicro.com/mac/stuffit/> )
or the freeware B<MacGzip> program (
-http://persephone.cps.unizar.es/general/gente/spd/gzip/gzip.html ).
+L<http://persephone.cps.unizar.es/general/gente/spd/gzip/gzip.html> ).
B. UNPACK
If you're using untarzipme or StuffIt, the archive should be extracted
now. B<Or>, you can use the freeware B<suntar> or I<Tar> (
-http://hyperarchive.lcs.mit.edu/HyperArchive/Archive/cmp/ ).
+L<http://hyperarchive.lcs.mit.edu/HyperArchive/Archive/cmp/> ).
C. BUILD
@@ -241,7 +241,7 @@ B<If you're on the DJGPP port of DOS,>
A. DECOMPRESS
-djtarx ( ftp://ftp.delorie.com/pub/djgpp/current/v2/ )
+djtarx ( L<ftp://ftp.delorie.com/pub/djgpp/current/v2/> )
will both uncompress and unpack.
B. UNPACK
@@ -271,7 +271,7 @@ You will need the packages mentioned in F<README.dos> in the Perl distribution.
B<If you're on OS/2,>
Get the EMX development suite and gzip/tar, from either Hobbes (
-http://hobbes.nmsu.edu ) or Leo ( http://www.leo.org ), and then follow
+L<http://hobbes.nmsu.edu> ) or Leo ( L<http://www.leo.org> ), and then follow
the instructions for Unix.
=item *
@@ -319,7 +319,7 @@ Or, if you're fond of VMS command syntax:
C. BUILD
Make sure you have MMS (from Digital) or the freeware MMK ( available
-from MadGoat at http://www.madgoat.com ). Then type this to create
+from MadGoat at L<http://www.madgoat.com> ). Then type this to create
the DESCRIP.MMS for the module:
perl Makefile.PL
@@ -350,7 +350,7 @@ A. DECOMPRESS
Decompress the file with C<gzip -d yourmodule.tar.gz>
You can get gzip from
-http://www.s390.ibm.com/products/oe/bpxqp1.html
+L<http://www.s390.ibm.com/products/oe/bpxqp1.html>
B. UNPACK
@@ -360,7 +360,7 @@ Unpack the result with
The BUILD and INSTALL steps are identical to those for Unix. Some
modules generate Makefiles that work better with GNU make, which is
-available from http://www.mks.com/s390/gnu/
+available from L<http://www.mks.com/s390/gnu/>
=back
diff --git a/pod/perlmodstyle.pod b/pod/perlmodstyle.pod
index 62390a4917..73e09b38cd 100644
--- a/pod/perlmodstyle.pod
+++ b/pod/perlmodstyle.pod
@@ -798,7 +798,7 @@ L<ExtUtils::MakeMaker>, L<Module::Build>
L<Test::Simple>, L<Test::Inline>, L<Carp::Assert>, L<Test::More>, L<Test::MockObject>
-=item http://pause.perl.org/
+=item L<http://pause.perl.org/>
Perl Authors Upload Server. Contains links to information for module
authors.
diff --git a/pod/perlnewmod.pod b/pod/perlnewmod.pod
index f3e7c692e6..61cc7bfc41 100644
--- a/pod/perlnewmod.pod
+++ b/pod/perlnewmod.pod
@@ -234,7 +234,7 @@ file.
=item Get a CPAN user ID
Every developer publishing modules on CPAN needs a CPAN ID. Visit
-C<http://pause.perl.org/>, select "Request PAUSE Account", and wait for
+C<L<http://pause.perl.org/>>, select "Request PAUSE Account", and wait for
your request to be approved by the PAUSE administrators.
=item C<perl Makefile.PL; make test; make distcheck; make dist>
@@ -276,5 +276,5 @@ Updated by Kirrily "Skud" Robert, C<skud@cpan.org>
L<perlmod>, L<perlmodlib>, L<perlmodinstall>, L<h2xs>, L<strict>,
L<Carp>, L<Exporter>, L<perlpod>, L<Test::Simple>, L<Test::More>
L<ExtUtils::MakeMaker>, L<Module::Build>, L<Module::Starter>
-L<http://www.cpan.org/>, Ken Williams's tutorial on building your own
+L<http://www.cpan.org/>, Ken Williams' tutorial on building your own
module at L<http://mathforum.org/~ken/perl_modules.html>
diff --git a/pod/perlop.pod b/pod/perlop.pod
index be809e6d3f..3b8b6708e8 100644
--- a/pod/perlop.pod
+++ b/pod/perlop.pod
@@ -217,8 +217,8 @@ are platform-dependent.
=head2 Symbolic Unary Operators
X<unary operator> X<operator, unary>
-Unary C<"!"> performs logical negation, that is, "not". See also C<not> for a lower
-precedence version of this.
+Unary C<"!"> performs logical negation, that is, "not". See also
+L<C<not>|/Logical Not> for a lower precedence version of this.
X<!>
Unary C<"-"> performs arithmetic negation if the operand is numeric,
diff --git a/pod/perlperf.pod b/pod/perlperf.pod
index 87d632f0d1..260acaba29 100644
--- a/pod/perlperf.pod
+++ b/pod/perlperf.pod
@@ -406,7 +406,7 @@ C<wordmatch> program. The wallclock, user and system, times are at the top of
the analysis, and after this are the main columns defining which define the
report. Check the C<dprofpp> docs for details of the many options it supports.
-See also C<Apache::DProf> which hooks C<Devel::DProf> into C<mod_perl>.
+See also C<L<Apache::DProf>> which hooks C<Devel::DProf> into C<mod_perl>.
=head2 Devel::Profiler
@@ -470,7 +470,8 @@ As the author of C<Devel::Proviler> writes:
YMMV.
-See also C<Devel::Apache::Profiler> which hooks C<Devel::Profiler> into C<mod_perl>.
+See also C<L<Devel::Apache::Profiler>> which hooks C<Devel::Profiler>
+into C<mod_perl>.
=head2 Devel::SmallProf
@@ -530,7 +531,8 @@ time. That regex line is looking a bit suspicious, for example. Remember that
these tools are supposed to be used together, there is no single best way to
profile your code, you need to use the best tools for the job.
-See also C<Apache::SmallProf> which hooks C<Devel::SmallProf> into C<mod_perl>.
+See also C<L<Apache::SmallProf>> which hooks C<Devel::SmallProf> into
+C<mod_perl>.
=head2 Devel::FastProf
@@ -749,7 +751,8 @@ sort of output you can expect from this cool tool.
Oodles of very useful information in there - this seems to be the way forward.
-See also C<Devel::NYTProf::Apache> which hooks C<Devel::NYTProf> into C<mod_perl>.
+See also C<L<Devel::NYTProf::Apache>> which hooks C<Devel::NYTProf> into
+C<mod_perl>.
=head1 SORTING
diff --git a/pod/perlpodstyle.pod b/pod/perlpodstyle.pod
index 22524a96fc..a2aecbacb8 100644
--- a/pod/perlpodstyle.pod
+++ b/pod/perlpodstyle.pod
@@ -276,7 +276,7 @@ section numbering conventions.
This documentation is maintained as part of the podlators distribution.
The current version is always available from its web site at
-<http://www.eyrie.org/~eagle/software/podlators/>.
+L<http://www.eyrie.org/~eagle/software/podlators/>.
=head1 AUTHOR
diff --git a/pod/perlre.pod b/pod/perlre.pod
index 7b483550f5..57a98e4466 100644
--- a/pod/perlre.pod
+++ b/pod/perlre.pod
@@ -2495,7 +2495,8 @@ at each matching starting point like so:
Any number of C<(*PRUNE)> assertions may be used in a pattern.
-See also C<< (?>pattern) >> and possessive quantifiers for other ways to
+See also C<<< L<< /(?>pattern) >> >>> and possessive quantifiers for
+other ways to
control backtracking. In some cases, the use of C<(*PRUNE)> can be
replaced with a C<< (?>pattern) >> with no functional difference; however,
C<(*PRUNE)> can be used to handle cases that cannot be expressed using a
diff --git a/pod/perlreftut.pod b/pod/perlreftut.pod
index cd17c8bb89..bd5d38e418 100644
--- a/pod/perlreftut.pod
+++ b/pod/perlreftut.pod
@@ -502,7 +502,7 @@ to do with references.
Author: Mark Jason Dominus, Plover Systems (C<mjd-perl-ref+@plover.com>)
This article originally appeared in I<The Perl Journal>
-( http://www.tpj.com/ ) volume 3, #2. Reprinted with permission.
+( L<http://www.tpj.com/> ) volume 3, #2. Reprinted with permission.
The original title was I<Understand References Today>.
diff --git a/pod/perlreref.pod b/pod/perlreref.pod
index db7c173a58..b9180bc0bf 100644
--- a/pod/perlreref.pod
+++ b/pod/perlreref.pod
@@ -393,7 +393,7 @@ for details on regexes and internationalisation.
=item *
I<Mastering Regular Expressions> by Jeffrey Friedl
-(F<http://oreilly.com/catalog/9780596528126/>) for a thorough grounding and
+(L<http://oreilly.com/catalog/9780596528126/>) for a thorough grounding and
reference on the topic.
=back
diff --git a/pod/perlthrtut.pod b/pod/perlthrtut.pod
index f5e35a3a5e..956214fbd0 100644
--- a/pod/perlthrtut.pod
+++ b/pod/perlthrtut.pod
@@ -1104,7 +1104,7 @@ Here's a short bibliography courtesy of Jürgen Christoffel:
Birrell, Andrew D. An Introduction to Programming with
Threads. Digital Equipment Corporation, 1989, DEC-SRC Research Report
#35 online as
-ftp://ftp.dec.com/pub/DEC/SRC/research-reports/SRC-035.pdf
+L<ftp://ftp.dec.com/pub/DEC/SRC/research-reports/SRC-035.pdf>
(highly recommended)
Robbins, Kay. A., and Steven Robbins. Practical Unix Programming: A
diff --git a/t/porting/known_pod_issues.dat b/t/porting/known_pod_issues.dat
index 44c13ffd10..e91119c5a9 100644
--- a/t/porting/known_pod_issues.dat
+++ b/t/porting/known_pod_issues.dat
@@ -17,7 +17,9 @@ access(2)
Algorithm::C3
Algorithm::Permute
AnyEvent
+Apache::DProf
Apache::MP3
+Apache::SmallProf
Archive::Extract
Array::Base
atan2(3)
@@ -78,6 +80,7 @@ DBI
DBIx::Profile
dbm(3)
dbm_open(3)
+Devel::Apache::Profiler
Devel::CallParser
Devel::Callsite
Devel::Cover
@@ -85,6 +88,7 @@ Devel::DProf
Devel::DTrace::Provider
Devel::InnerPackage
Devel::NYTProf
+Devel::NYTProf::Apache
Devel::PPPort
Devel::SawAmpersand
Devel::Spy