This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
I like doubleclicking on URLs in pods to select them.
authorJarkko Hietaniemi <jhi@iki.fi>
Wed, 27 Mar 2002 02:40:33 +0000 (02:40 +0000)
committerJarkko Hietaniemi <jhi@iki.fi>
Wed, 27 Mar 2002 02:40:33 +0000 (02:40 +0000)
p4raw-id: //depot/perl@15542

18 files changed:
README.amiga
README.epoc
README.vos
pod/perl561delta.pod
pod/perl570delta.pod
pod/perl571delta.pod
pod/perldelta.pod
pod/perlfaq1.pod
pod/perlfaq2.pod
pod/perlfaq3.pod
pod/perlfaq9.pod
pod/perlhack.pod
pod/perlmodinstall.pod
pod/perlmodlib.PL
pod/perlmodlib.pod
pod/perlport.pod
pod/perltodo.pod
pod/perlvar.pod

index 44effb4..f287d65 100644 (file)
@@ -59,7 +59,8 @@ Contents
 
 You need the Unix emulation for AmigaOS, whose most important part is
 B<ixemul.library>. 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
index a098c2b..a235f01 100644 (file)
@@ -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.
index 016d6c9..11424c2 100644 (file)
@@ -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
index ccd9c8d..40dd85b 100644 (file)
@@ -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
 
index 93154b6..9ca2dfa 100644 (file)
@@ -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
 
index 8047871..2975c06 100644 (file)
@@ -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 *
 
index 38191b0..59de7fd 100644 (file)
@@ -349,7 +349,7 @@ and L<perlunicode> 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
 
index 89fe4dd..dcaed06 100644 (file)
@@ -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).
index ad7351d..10839fe 100644 (file)
@@ -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<not> 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
 
index ff79139..980e344 100644 (file)
@@ -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<rep ps axu> similar to B<top>.
 
index 4b50073..242bd49 100644 (file)
@@ -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</^[\w.-]+\@(?:[\w-]+\.)+\w+$/>.  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
index bb54e73..1709e0e 100644 (file)
@@ -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<perlxstut> and L<perlxs>
 
index c89b381..7e6a917 100644 (file)
@@ -75,7 +75,7 @@ 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 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<nmake> 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
 
index 60a4061..b3cf7f4 100644 (file)
@@ -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
index 20fffc8..3a68707 100644 (file)
@@ -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
index 823a2c6..f70e096 100644 (file)
@@ -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
 
index eea756b..22b396b 100644 (file)
@@ -829,7 +829,7 @@ Use C<Inline::CPR>.
 
 =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
 
index 744e636..a42f8c6 100644 (file)
@@ -1428,7 +1428,7 @@ expression matches in a program, regardless of whether they occur
 in the scope of C<use English>.  For that reason, saying C<use
 English> 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