From 1577cd8083ce36a55c5a17443a5fe2c735f08e36 Mon Sep 17 00:00:00 2001 From: Jarkko Hietaniemi Date: Wed, 27 Mar 2002 02:40:33 +0000 Subject: [PATCH] I like doubleclicking on URLs in pods to select them. p4raw-id: //depot/perl@15542 --- README.amiga | 3 ++- README.epoc | 4 ++-- README.vos | 4 ++-- pod/perl561delta.pod | 2 +- pod/perl570delta.pod | 2 +- pod/perl571delta.pod | 10 +++++----- pod/perldelta.pod | 4 ++-- pod/perlfaq1.pod | 4 ++-- pod/perlfaq2.pod | 6 +++--- pod/perlfaq3.pod | 24 ++++++++++++------------ pod/perlfaq9.pod | 6 +++--- pod/perlhack.pod | 4 ++-- pod/perlmodinstall.pod | 10 +++++----- pod/perlmodlib.PL | 2 +- pod/perlmodlib.pod | 2 +- pod/perlport.pod | 2 +- pod/perltodo.pod | 2 +- pod/perlvar.pod | 2 +- 18 files changed, 47 insertions(+), 46 deletions(-) diff --git a/README.amiga b/README.amiga index 44effb4..f287d65 100644 --- a/README.amiga +++ b/README.amiga @@ -59,7 +59,8 @@ Contents You need the Unix emulation for AmigaOS, whose most important part is B. For a minimum setup, get the latest versions -of the following packages from the Aminet archives (http://www.aminet.net/~aminet/): +of the following packages from the Aminet archives +( http://www.aminet.net/~aminet/ ): ixemul-bin ixemul-env-bin diff --git a/README.epoc b/README.epoc index a098c2b..a235f01 100644 --- a/README.epoc +++ b/README.epoc @@ -23,7 +23,7 @@ http://www.windhager.de/~mattes/epocemx/ perl and epocemx runs on Epoc Release 5 machines: Psion 5mx, 5mx Pro, Psion Revo, Psion Netbook and on the Ericson M128. It may run on Epoc Release 3 Hardware (Series 5 classic), too. For more information about -this hardware please refer to http://www.psion.com. +this hardware please refer to http://www.psion.com/ Vendors which like to have support for their devices are free to send me a sample. @@ -31,7 +31,7 @@ me a sample. =head1 INSTALLING PERL ON EPOC You can download a ready-to-install version from -http://www.science-computing.de/o.flebbe/perl. +http://www.science-computing.de/o.flebbe/perl/ You will need at least ~6MB free space in order to install and run perl. diff --git a/README.vos b/README.vos index 016d6c9..11424c2 100644 --- a/README.vos +++ b/README.vos @@ -20,7 +20,7 @@ from ftp://ftp.stratus.com/pub/vos/posix/alpha/alpha.html. If you are running VOS Release 14.3.0 or later, download Perl from ftp://ftp.stratus.com/pub/vos/posix/ga/ga.html. Instructions for unbundling the Perl distribution file are at -ftp://ftp.stratus.com/pub/vos/utility/utility.html. +ftp://ftp.stratus.com/pub/vos/utility/utility.html If you are running VOS Release 14.4.1 or later, you can obtain a pre-compiled, supported copy of perl by purchasing Release 2.0.1 @@ -169,7 +169,7 @@ binary file-transfer mode. Or use the Uniform Resource Locator (URL) ftp://ftp.stratus.com/pub/vos/posix/alpha/posix.save.evf.gz from your web browser. Instructions for unbundling this file -are at ftp://ftp.stratus.com/pub/vos/utility/utility.html. +are at ftp://ftp.stratus.com/pub/vos/utility/utility.html This is not a standard Stratus product. In VOS Release 14.3.0, the generally-available version of diff --git a/pod/perl561delta.pod b/pod/perl561delta.pod index ccd9c8d..40dd85b 100644 --- a/pod/perl561delta.pod +++ b/pod/perl561delta.pod @@ -23,7 +23,7 @@ a /bin/mail that is vulnerable to buffer overflow attacks. Note that suidperl is neither built nor installed by default in any recent version of perl. Use of suidperl is highly discouraged. If you think you need it, try alternatives such as sudo first. -See http://www.courtesan.com/sudo/. +See http://www.courtesan.com/sudo/ . =head2 Core bug fixes diff --git a/pod/perl570delta.pod b/pod/perl570delta.pod index 93154b6..9ca2dfa 100644 --- a/pod/perl570delta.pod +++ b/pod/perl570delta.pod @@ -31,7 +31,7 @@ and if deemed too risky to continue to be supported, it may be completely removed from future releases. In any case, suidperl should only be used by security experts who know exactly what they are doing and why they are using suidperl instead of some other solution such as -sudo (see http://www.courtesan.com/sudo/). +sudo ( see http://www.courtesan.com/sudo/ ). =head1 Incompatible Changes diff --git a/pod/perl571delta.pod b/pod/perl571delta.pod index 8047871..2975c06 100644 --- a/pod/perl571delta.pod +++ b/pod/perl571delta.pod @@ -38,8 +38,8 @@ possible. The suidperl code is being reviewed and if deemed too risky to continue to be supported, it may be completely removed from future releases. In any case, suidperl should only be used by security experts who know exactly what they are doing and why they are using -suidperl instead of some other solution such as sudo (see -http://www.courtesan.com/sudo/). +suidperl instead of some other solution such as sudo +( see http://www.courtesan.com/sudo/ ). =head1 Incompatible Changes @@ -175,7 +175,7 @@ particularly tricky to get right, so you have been warned) =item * The Unicode Character Database coming with Perl has been upgraded -to Unicode 3.1. For more information, see http://www.unicode.org/, +to Unicode 3.1. For more information, see http://www.unicode.org/ , and http://www.unicode.org/unicode/reports/tr27/ For developers interested in enhancing Perl's Unicode capabilities: @@ -450,8 +450,8 @@ Class::Struct can now define the classes in compile time. Math::BigFloat has undergone much fixing, and in addition the fmod() function now supports modulus operations. -(The fixed Math::BigFloat module is also available in CPAN for those -who can't upgrade their Perl: http://www.cpan.org/authors/id/J/JP/JPEACOCK/) +( The fixed Math::BigFloat module is also available in CPAN for those +who can't upgrade their Perl: http://www.cpan.org/authors/id/J/JP/JPEACOCK/ ) =item * diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 38191b0..59de7fd 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -349,7 +349,7 @@ and L for details. =item * The Unicode Character Database coming with Perl has been upgraded -to Unicode 3.1.1. For more information, see http://www.unicode.org/. +to Unicode 3.1.1. For more information, see http://www.unicode.org/ . =item * @@ -2556,7 +2556,7 @@ unfortunately, always possible. The suidperl functionality is most probably going to be removed in Perl 5.10. In any case, suidperl should only be used by security experts who know exactly what they are doing and why they are using suidperl instead of some other solution -such as sudo (see http://www.courtesan.com/sudo/). +such as sudo ( see http://www.courtesan.com/sudo/ ). =head1 New Tests diff --git a/pod/perlfaq1.pod b/pod/perlfaq1.pod index 89fe4dd..dcaed06 100644 --- a/pod/perlfaq1.pod +++ b/pod/perlfaq1.pod @@ -36,11 +36,11 @@ In particular, the core development team (known as the Perl Porters) are a rag-tag band of highly altruistic individuals committed to producing better software for free than you could hope to purchase for money. You may snoop on pending developments via the archives at -http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/ +http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/ and http://archive.develooper.com/perl5-porters@perl.org/ or the news gateway nntp://nntp.perl.org/perl.perl5.porters or its web interface at http://nntp.perl.org/group/perl.perl5.porters , -or read the faq at http://perlhacker.org/p5p-faq, +or read the faq at http://perlhacker.org/p5p-faq , or you can subscribe to the mailing list by sending perl5-porters-request@perl.org a subscription request (an empty message with no subject is fine). diff --git a/pod/perlfaq2.pod b/pod/perlfaq2.pod index ad7351d..10839fe 100644 --- a/pod/perlfaq2.pod +++ b/pod/perlfaq2.pod @@ -186,7 +186,7 @@ following groups: There is also a Usenet gateway to Perl mailing lists sponsored by perl.org at nntp://nntp.perl.org, or a web interface to the same lists at http://nntp.perl.org/group/. Other groups are listed at -http://lists.perl.org. +http://lists.perl.org/ =head2 Where should I post source code? @@ -394,7 +394,7 @@ http://www.stonehenge.com/merlyn/LinuxMag/ . To get the best performance, pick a site from the list below and use it to grab the complete list of mirror sites -which is at /CPAN/MIRRORED.BY or at http://mirror.cpan.org/. +which is at /CPAN/MIRRORED.BY or at http://mirror.cpan.org/ From there you can find the quickest site for you. Remember, the following list is I the complete list of CPAN mirrors (the complete list contains 165 sites as of January 2001): @@ -420,7 +420,7 @@ Most of the major modules (Tk, CGI, libwww-perl) have their own mailing lists. Consult the documentation that came with the module for subscription information. - http://lists.cpan.org/ + http://lists.cpan.org/ =head2 Archives of comp.lang.perl.misc diff --git a/pod/perlfaq3.pod b/pod/perlfaq3.pod index ff79139..980e344 100644 --- a/pod/perlfaq3.pod +++ b/pod/perlfaq3.pod @@ -156,7 +156,7 @@ http://www.cpan.org/authors/id/TOMC/scripts/toms.exrc.gz The a2ps http://www-inf.enst.fr/%7Edemaille/a2ps/black+white.ps.gz does lots of things related to generating nicely printed output of -documents, as does enscript at http://people.ssh.fi/mtr/genscript/. +documents, as does enscript at http://people.ssh.fi/mtr/genscript/ =head2 Is there a ctags for Perl? @@ -187,7 +187,7 @@ multi-language IDE has Perl support, including a regular expression debugger and remote debugging (http://www.ActiveState.com/Products/Komodo/index.html). (Visual Perl, a Visual Studio.NET plug-in is currently (early 2001) in beta -(http://www.ActiveState.com/Products/VisualPerl/index.html)). +( http://www.ActiveState.com/Products/VisualPerl/index.html )). =item The Object System @@ -244,8 +244,8 @@ specifically for programming, such as Textpad If you are using MacOS, the same concerns apply. MacPerl (for Classic environments) comes with a simple editor. -Popular external editors are BBEdit (http://www.bbedit.com) -or Alpha (http://alpha.olm.net/). MacOS X users can use Unix +Popular external editors are BBEdit ( http://www.bbedit.com/ ) +or Alpha ( http://alpha.olm.net/ ). MacOS X users can use Unix editors as well. =over 4 @@ -285,7 +285,7 @@ win32: http://www.cs.vu.nl/%7Etmgil/vi.html =back For vi lovers in general, Windows or elsewhere: -http://www.thomer.com/thomer/vi/vi.html. +http://www.thomer.com/thomer/vi/vi.html nvi (http://www.bostic.com/vi/, available from CPAN in src/misc/) is yet another vi clone, unfortunately not available for Windows, but in @@ -327,12 +327,12 @@ powerful shell environment for Win32. Your options include =item Bash -from the Cygwin package (http://sources.redhat.com/cygwin/) +from the Cygwin package ( http://sources.redhat.com/cygwin/ ) =item Ksh from the MKS Toolkit (http://www.mks.com/), or the Bourne shell of -the U/WIN environment (http://www.research.att.com/sw/tools/uwin/) +the U/WIN environment ( http://www.research.att.com/sw/tools/uwin/ ) =item Tcsh @@ -365,18 +365,18 @@ no 32k limit). =item BBEdit and BBEdit Lite are text editors for Mac OS that have a Perl sensitivity mode -(http://web.barebones.com/). +( http://web.barebones.com/ ). =item Alpha is an editor, written and extensible in Tcl, that nonetheless has built in support for several popular markup and programming languages -including Perl and HTML (http://alpha.olm.net/). +including Perl and HTML ( http://alpha.olm.net/ ). =back Pepper and Pe are programming language sensitive text editors for Mac -OS X and BeOS respectively (http://www.hekkelman.com/). +OS X and BeOS respectively ( http://www.hekkelman.com/ ). =head2 Where can I get Perl macros for vi? @@ -384,7 +384,7 @@ For a complete version of Tom Christiansen's vi configuration file, see http://www.cpan.org/authors/Tom_Christiansen/scripts/toms.exrc.gz , the standard benchmark file for vi emulators. The file runs best with nvi, the current version of vi out of Berkeley, which incidentally can be built -with an embedded Perl interpreter--see http://www.cpan.org/src/misc. +with an embedded Perl interpreter--see http://www.cpan.org/src/misc/ =head2 Where can I get perl-mode for emacs? @@ -405,7 +405,7 @@ shouldn't be an issue. The Curses module from CPAN provides a dynamically loadable object module interface to a curses library. A small demo can be found at the -directory http://www.cpan.org/authors/Tom_Christiansen/scripts/rep; +directory http://www.cpan.org/authors/Tom_Christiansen/scripts/rep ; this program repeats a command and updates the screen as needed, rendering B similar to B. diff --git a/pod/perlfaq9.pod b/pod/perlfaq9.pod index 4b50073..242bd49 100644 --- a/pod/perlfaq9.pod +++ b/pod/perlfaq9.pod @@ -16,9 +16,9 @@ a program ("CGI script") and a web server (HTTPD). It is not specific to Perl, and has its own FAQs and tutorials, and usenet group, comp.infosystems.www.authoring.cgi -The original CGI specification is at: http://hoohoo.ncsa.uiuc.edu/cgi/ +The original CGI specification is at: http://hoohoo.ncsa.uiuc.edu/cgi/ -Current best-practice RFC draft at: http://CGI-Spec.Golux.Com/ +Current best-practice RFC draft at: http://CGI-Spec.Golux.Com/ Other relevant documentation listed in: http://www.perl.org/CGI_MetaFAQ.html @@ -382,7 +382,7 @@ mail addresses with a simple regex, such as C. It's a very bad idea. However, this also throws out many valid ones, and says nothing about potential deliverability, so it is not suggested. Instead, see -http://www.cpan.org/authors/Tom_Christiansen/scripts/ckaddr.gz, +http://www.cpan.org/authors/Tom_Christiansen/scripts/ckaddr.gz , which actually checks against the full RFC spec (except for nested comments), looks for addresses you may not wish to accept mail to (say, Bill Clinton or your postmaster), and then makes sure that the diff --git a/pod/perlhack.pod b/pod/perlhack.pod index bb54e73..1709e0e 100644 --- a/pod/perlhack.pod +++ b/pod/perlhack.pod @@ -278,7 +278,7 @@ Set up a local rsync server which makes the rsynced source tree available to the LAN and sync the other machines against this directory. -From http://rsync.samba.org/README.html: +From http://rsync.samba.org/README.html : "Rsync uses rsh or ssh for communication. It does not need to be setuid and requires no special privileges for installation. It @@ -591,7 +591,7 @@ source, and we'll do that later on. You might also want to look at Gisle Aas's illustrated perlguts - there's no guarantee that this will be absolutely up-to-date with the latest documentation in the Perl core, but the fundamentals will be -right. (http://gisle.aas.no/perl/illguts/) +right. ( http://gisle.aas.no/perl/illguts/ ) =item L and L diff --git a/pod/perlmodinstall.pod b/pod/perlmodinstall.pod index c89b381..7e6a917 100644 --- a/pod/perlmodinstall.pod +++ b/pod/perlmodinstall.pod @@ -75,7 +75,7 @@ A. DECOMPRESS Decompress the file with C -You can get gzip from ftp://prep.ai.mit.edu/pub/gnu. +You can get gzip from ftp://prep.ai.mit.edu/pub/gnu/ Or, you can combine this step with the next to save disk space: @@ -143,7 +143,7 @@ in .xs, .c, .h, .y, .cc, .cxx, or .C)? If it doesn't, go to INSTALL. If it does, life is now officially tough for you, because you have to compile the module yourself -- no easy feat on Windows. You'll need the C utility, available at -ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe. +ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe D. INSTALL @@ -192,9 +192,9 @@ must be compiled, and you cannot install it "out of the box." If a module does not work on MacPerl but should, or needs to be compiled, see if the module exists already as a port on the -MacPerl Module Porters site (http://pudge.net/mmp/). +MacPerl Module Porters site ( http://pudge.net/mmp/ ). For more information on doing XS with MacPerl yourself, see -Arved Sandstrom's XS tutorial (http://macperl.com/depts/Tutorials/), +Arved Sandstrom's XS tutorial ( http://macperl.com/depts/Tutorials/ ), and then consider uploading your binary to the CPAN and registering it on the MMP site. @@ -363,7 +363,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/index.htm. +available from http://www.mks.com/s390/gnu/ =back diff --git a/pod/perlmodlib.PL b/pod/perlmodlib.PL index 60a4061..b3cf7f4 100644 --- a/pod/perlmodlib.PL +++ b/pod/perlmodlib.PL @@ -165,7 +165,7 @@ CPAN stands for Comprehensive Perl Archive Network; it's a globally replicated trove of Perl materials, including documentation, style guides, tricks and traps, alternate ports to non-Unix systems and occasional binary distributions for these. Search engines for -CPAN can be found at http://www.cpan.org/. +CPAN can be found at http://www.cpan.org/ Most importantly, CPAN includes around a thousand unbundled modules, some of which require a C compiler to build. Major categories of diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod index 20fffc8..3a68707 100644 --- a/pod/perlmodlib.pod +++ b/pod/perlmodlib.pod @@ -939,7 +939,7 @@ CPAN stands for Comprehensive Perl Archive Network; it's a globally replicated trove of Perl materials, including documentation, style guides, tricks and traps, alternate ports to non-Unix systems and occasional binary distributions for these. Search engines for -CPAN can be found at http://www.cpan.org/. +CPAN can be found at http://www.cpan.org/ Most importantly, CPAN includes around a thousand unbundled modules, some of which require a C compiler to build. Major categories of diff --git a/pod/perlport.pod b/pod/perlport.pod index 823a2c6..f70e096 100644 --- a/pod/perlport.pod +++ b/pod/perlport.pod @@ -2148,7 +2148,7 @@ Support for the following platform is planned for a future Perl release: Netware The following platforms have their own source code distributions and -binaries available via http://www.cpan.org/ports/index.html: +binaries available via http://www.cpan.org/ports/ Perl release diff --git a/pod/perltodo.pod b/pod/perltodo.pod index eea756b..22b396b 100644 --- a/pod/perltodo.pod +++ b/pod/perltodo.pod @@ -829,7 +829,7 @@ Use C. =head2 man for perl -See the Perl Power Tools. (http://language.perl.com/ppt/) +See the Perl Power Tools. ( http://language.perl.com/ppt/ ) =head2 my $Package::variable diff --git a/pod/perlvar.pod b/pod/perlvar.pod index 744e636..a42f8c6 100644 --- a/pod/perlvar.pod +++ b/pod/perlvar.pod @@ -1428,7 +1428,7 @@ expression matches in a program, regardless of whether they occur in the scope of C. For that reason, saying C in libraries is strongly discouraged. See the Devel::SawAmpersand module documentation from CPAN -(http://www.cpan.org/modules/by-module/Devel/) +( http://www.cpan.org/modules/by-module/Devel/ ) for more information. Having to even think about the C<$^S> variable in your exception -- 2.7.4