diff options
author | Karl Williamson <khw@cpan.org> | 2017-03-30 22:10:46 -0600 |
---|---|---|
committer | Karl Williamson <khw@cpan.org> | 2017-04-05 11:28:08 -0600 |
commit | 4b05bc8ea5a106c203e7154f3cbae72e133c9c80 (patch) | |
tree | 97252ee73ea15fb216e5dced1f914bf294883199 | |
parent | 5fc389563644287b3e5f448616ce62dd0ce4e7a6 (diff) | |
download | perl-4b05bc8ea5a106c203e7154f3cbae72e133c9c80.tar.gz |
pods: Add L<> for links missing them; a couple nits
-rw-r--r-- | Porting/how_to_write_a_perldelta.pod | 2 | ||||
-rw-r--r-- | Porting/pumpkin.pod | 4 | ||||
-rw-r--r-- | Porting/release_managers_guide.pod | 16 | ||||
-rw-r--r-- | README.aix | 2 | ||||
-rw-r--r-- | README.freebsd | 2 | ||||
-rw-r--r-- | README.hurd | 2 | ||||
-rw-r--r-- | README.jp | 4 | ||||
-rw-r--r-- | README.os390 | 2 | ||||
-rw-r--r-- | pod/perlembed.pod | 4 | ||||
-rw-r--r-- | pod/perlgit.pod | 4 | ||||
-rw-r--r-- | pod/perlhack.pod | 6 | ||||
-rw-r--r-- | pod/perlhacktips.pod | 6 | ||||
-rw-r--r-- | pod/perlintro.pod | 2 | ||||
-rw-r--r-- | pod/perlmodinstall.pod | 34 | ||||
-rw-r--r-- | pod/perlmodstyle.pod | 2 | ||||
-rw-r--r-- | pod/perlnewmod.pod | 4 | ||||
-rw-r--r-- | pod/perlop.pod | 4 | ||||
-rw-r--r-- | pod/perlperf.pod | 11 | ||||
-rw-r--r-- | pod/perlpodstyle.pod | 2 | ||||
-rw-r--r-- | pod/perlre.pod | 3 | ||||
-rw-r--r-- | pod/perlreftut.pod | 2 | ||||
-rw-r--r-- | pod/perlreref.pod | 2 | ||||
-rw-r--r-- | pod/perlthrtut.pod | 2 | ||||
-rw-r--r-- | t/porting/known_pod_issues.dat | 4 |
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. @@ -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 |