-Last Revised 02-June-1998 by Dan Sugalski <sugalskd@ous.edu>
+Last Revised 21-July-1998 by Dan Sugalski <sugalskd@ous.edu>
Originally by Charles Bailey <bailey@newman.upenn.edu>
* Important safety tip
releases! Make sure you read the "Building Perl" and "Installing Perl"
sections before you build or install.
+Also note that, as of 5.005, an ANSI C compliant compiler is required to
+build Perl. Vax C is *not* ANSI compliant, as it died a natural death some
+time before the standard was set. Therefore Vax C will not compile perl
+5.005. Sorry about that.
+
+If you're stuck without Dec C (the Vax C license should be good for Dec C,
+but the media charges might prohibit an upgrade), consider getting Gnu C
+instead.
+
* Intro
The VMS port of Perl is as functionally complete as any other Perl port
* Other required software
In addition to VMS, you'll need:
- 1) A C compiler. Dec C for AXP, or VAX C, Dec C, or gcc for the
- VAX.
+ 1) A C compiler. Dec C for AXP, or Dec C, or gcc for the VAX.
2) A make tool. Dec's MMS (v2.6 or later), or MadGoat's free MMS
analog MMK (available from ftp.madgoat.com/madgoat) both work
just fine. Gnu Make might work, but it's been so long since
compiler and network stack) will determine how perl's built.
If you've got multiple C compilers installed, you'll have your choice of
-which one to use. Using Dec C is recommended over Vax C--the compiler is
-newer, and supported. (Vax C was decommisioned around 1993) Various older
-versions had some gotchas, so if you're using a version older than 5.2,
-check the Dec C Issues section.
-
-We'll also point out that Dec C will get you at least a ten-fold increase
-in line-oriented IO over Vax C. The optimizer is amazingly better, too. If
-you can use Dec C, then you *really*, *really* should.
+which one to use. Various older versions of Dec C had some gotchas, so if
+you're using a version older than 5.2, check the Dec C Issues section.
The configuration script will print out, at the very end, the MMS or MMK
command you need to compile perl. Issue it (exactly as printed) to start
@CONFIGURE "-des"
(note the quotes and case) will choose reasonable defaults. (It takes Dec C
-over Vax C, Dec C sockets over SOCKETSHR sockets, and either over no sockets)
+over Gnu C, Dec C sockets over SOCKETSHR sockets, and either over no sockets)
* Testing Perl
your DCL$PATH (if you're using VMS 6.2 or higher).
4) Optionally define the command PERLDOC as
-PERLDOC :== $PERL_ROOT:[000000]PERL PERL_ROOT:[LIB.POD]PERLDOC.COM -T
+PERLDOC :== "$PERL_ROOT:[000000]PERL PERL_ROOT:[LIB.POD]PERLDOC.COM -T"
Note that if you wish to use most as a pager please see
ftp://space.mit.edu/pub/davis/ for both most and slang.
5) Optionally define the command PERLBUG (the Perl bug report generator) as
-PERLBUG :== $PERL_ROOT:[000000]PERL PERL_ROOT:[LIB]PERLBUG.COM"
+PERLBUG :== "$PERL_ROOT:[000000]PERL PERL_ROOT:[LIB]PERLBUG.COM"
6) Optionally define the command POD2MAN (Converts POD files to nroff
source suitable for converting to man pages. Also quiets complaints during
module builds) as
DEFINE/NOLOG POD2MAN PERL_ROOT:[LIB.POD]POD2MAN.COM
-POD2MAN :== $PERL_ROOT:[000000]PERL POD2MAN
+POD2MAN :== "$PERL_ROOT:[000000]PERL POD2MAN"
+
+7) Optionally define the command POD2TEXT (Converts POD files to text,
+which is required for perldoc -f to work properly) as
+
+DEFINE/NOLOG POD2TEXT PERL_ROOT:[LIB.POD]POD2TEXT.COM
+POD2TEXT :== "$PERL_ROOT:[000000]PERL POD2TEXT"
+
+In all these cases, if you've got PERL defined as a foreign command, you
+can replace $PERL_ROOT:[000000]PERL with ''perl'. If you've installed perl
+into DCLTABLES, replace it with just perl.
* Installing Perl into DCLTABLES