X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlmodinstall.pod;h=7e6a9170b54f8ea8d11974499874642e85cfbcfb;hb=e13efe3ceea1a416bee536860751edb48e6bfcb3;hp=ccc6cd643632f1adf2fa81cadb1fbbe35d8351db;hpb=b3539c74f8792e5b6cd751bc81b0916c44ee6648;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlmodinstall.pod b/pod/perlmodinstall.pod index ccc6cd6..7e6a917 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 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.perl.com/CPAN/modules/04pause.html +as a Perl developer at 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.perl.com/CPAN/. +http://www.cpan.org/ , and searched at http://search.cpan.org/ . This documentation is for people who want to download CPAN modules and install them on their own computer. @@ -19,7 +19,7 @@ and install them on their own computer. First, are you sure that the module isn't already on your system? Try C. (Replace "Foo" with the name of the module; for -instance, C. +instance, C. If you don't see an error message, you have the module. (If you do see an error message, it's still possible you have the module, but @@ -45,7 +45,7 @@ take: =back Here's how to perform each step for each operating system. This is -I a substitute for reading the README and INSTALL files that + a substitute for reading the README and INSTALL files that might have come with your module! Also note that these instructions are tailored for installing the @@ -59,7 +59,7 @@ sometimes just C. If you're on a system that requires superuser/root access to install modules into the directories you see when you type C, you'll want to install them into a local directory (such as your home -directory) and use this approach. +directory) and use this approach. =over 4 @@ -67,15 +67,15 @@ directory) and use this approach. B -You can use Andreas Koenig's CPAN module -( http://www.perl.com/CPAN/modules/by-module/CPAN ) +You can use Andreas Koenig's CPAN module +( http://www.cpan.org/modules/by-module/CPAN ) to automate the following steps, from DECOMPRESS through INSTALL. -A. DECOMPRESS +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: @@ -93,7 +93,7 @@ Go into the newly-created directory and type: make make test -or +or perl Makefile.PL PREFIX=/my/perl_directory @@ -143,12 +143,12 @@ 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 Copy the module into your Perl's I directory. That'll be one -of the directories you see when you type +of the directories you see when you type perl -e 'print "@INC"' @@ -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. @@ -242,7 +242,7 @@ B A. DECOMPRESS djtarx ( ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2/ ) -will both uncompress and unpack. +will both uncompress and unpack. B. UNPACK @@ -256,7 +256,7 @@ Go into the newly-created directory and type: make make test -You will need the packages mentioned in C +You will need the packages mentioned in F in the Perl distribution. D. INSTALL @@ -264,8 +264,8 @@ in the Perl distribution. While still in that directory, type: make install - -You will need the packages mentioned in Readme.dos in the Perl distribution. + +You will need the packages mentioned in F in the Perl distribution. =item * @@ -287,20 +287,22 @@ C. A. DECOMPRESS -Type +Type gzip -d Your-Module.tgz -or, for zipped modules, type +or, for zipped modules, type unzip Your-Module.zip -Executables for gzip, zip, and VMStar ( Alphas: -http://www.openvms.digital.com/cd/000TOOLS/ALPHA/ and Vaxen: -http://www.openvms.digital.com/cd/000TOOLS/VAX/ ). +Executables for gzip, zip, and VMStar: + + http://www.openvms.digital.com/freeware/ + http://www.crinoid.com/utils/ + +and their source code: -gzip and tar -are also available at ftp://ftp.digital.com/pub/VMS. + http://www.fsf.org/order/ftp.html Note that GNU's gzip/gunzip is not the same as Info-ZIP's zip/unzip package. The former is a simple compression tool; the latter permits @@ -316,10 +318,11 @@ Or, if you're fond of VMS command syntax: tar/extract/verbose Your_Module.tar -C. BUILD +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 the -DESCRIP.MMS for the module: +Make sure you have MMS (from Digital) or the freeware MMK ( available +from MadGoat at http://www.madgoat.com ). Then type this to create +the DESCRIP.MMS for the module: perl Makefile.PL @@ -332,7 +335,7 @@ Substitute C for C above if you're using MMK. D. INSTALL -Type +Type mms install @@ -342,25 +345,25 @@ Substitute C for C above if you're using MMK. B, -Introduce the .tar.gz file into an HFS as binary; don't translate from +Introduce the F<.tar.gz> file into an HFS as binary; don't translate from ASCII to EBCDIC. -A. DECOMPRESS +A. DECOMPRESS - Decompress the file with C +Decompress the file with C - You can get gzip from - http://www.s390.ibm.com/products/oe/bpxqp1.html. +You can get gzip from +http://www.s390.ibm.com/products/oe/bpxqp1.html B. UNPACK -Unpack the result with +Unpack the result with pax -o to=IBM-1047,from=ISO8859-1 -r < yourmodule.tar 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 @@ -420,7 +423,7 @@ familiar with Perl on your operating system. =head1 AUTHOR -Jon Orwant +Jon Orwant orwant@tpj.com @@ -436,7 +439,7 @@ First version July 22, 1998; last revised November 21, 2001. =head1 COPYRIGHT -Copyright (C) 1998, 2001 Jon Orwant. All Rights Reserved. +Copyright (C) 1998, 2002 Jon Orwant. All Rights Reserved. Permission is granted to make and distribute verbatim copies of this documentation provided the copyright notice and this permission notice are