X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/c07a80fdfe3926b5eb0585b674aa5d1f57b32ade..ba4e42d92623c3bf7db4c55472684fb46bbe2b20:/README.vms diff --git a/README.vms b/README.vms index a530103..ba0ba19 100644 --- a/README.vms +++ b/README.vms @@ -163,24 +163,27 @@ set up to use VAXC on a VAX, and does not include socket support. You can either edit the Makefile by hand, using Descrip.MMS as a guide, or use the Makefile to build Miniperl.Exe, and then run the Perl script MMS2Make.pl, found in the [.VMS] subdirectory, to generate a new Makefile with the options -appropriate to your site. If you are using MM[SK], and you decide to rebuild -Perl with a different set of parameters (e.g. changing the C compiler, or -adding socket support), be sure to say +appropriate to your site. + +If you are using MM[SK], and you decide to rebuild Perl with a different set +of parameters (e.g. changing the C compiler, or adding socket support), be +sure to say $ MMK/Descrip=[.VMS] realclean first, in order to remove files generated during the previous build. If you omit this step, you risk ending up with a copy of Perl which composed partially of old files and partially of new ones, which may lead to strange effects when you try to run Perl. -Note for sites using DECC: A bug in some early versions of the DECC RTL on the -AXP causes newlines to be lost when writing to a pipe. This causes -Gen_ShrFls.pl to fail, since it can't read the preprocessor output to identify -global variables and routines. A different bug in the DECC preprocessor itself -for some patched versions of DECC 4.0 on the VAX also makes it impossible for -Gen_ShrFls.pl to parse the preprocessor output. In either case, the problem is -generally manifested as missing global symbols when linking PerlShr.Exe or -Perl.Exe. You can work around this problem by defining the macro -DECC_PIPES_BROKEN when you invoke MMS or MMK. +A bug in some early versions of the DECC RTL on the AXP causes newlines +to be lost when writing to a pipe. A different bug in some patched versions +of DECC 4.0 for VAX can also scramble preprocessor output. Finally, gcc 2.7.2 +has yet another preprocessor bug, which causes line breaks to be inserted +into the output at inopportune times. Each of these bugs causes Gen_ShrFls.pl +to fail, since it can't parse the preprocessor output to identify global +variables and routines. This problem is generally manifested as missing +global symbols when linking PerlShr.Exe or Perl.Exe. You can work around +it by defining the macro PIPES_BROKEN when you invoke MMS or MMK. + This will build the following files: Miniperl.Exe - a stand-alone version of without any extensions. @@ -210,7 +213,7 @@ This will build the following files: h2xs - Perl program which generates template files for creating XSUB extensions, optionally beginning with the #defined constants in a C header file. - [.pod]perldoc - A Perl program which locates and displays documentation + [.lib.pod]perldoc - A Perl program which locates and displays documentation for Perl and its extensions. [.Lib]Config.pm - the Perl extension which saves configuration information about Perl and your system. @@ -252,7 +255,10 @@ a spectrum of possibilities. Once the build is complete, you'll need to do the following: - Put PerlShr.Exe in a common directory, and make it world-readable. If you place it in a location other than Sys$Share, you'll need to - define the logical name PerlShr to point to the image. + define the logical name PerlShr to point to the image. (If you're + installing on a VMScluster, be sure that each node is using the + copy of PerlShr you expect [e.g. if you put PerlShr.Exe in Sys$Share, + do they all share Sys$Share?]). - Put Perl.Exe in a common directory, and make it world-executable. - Define a foreign command to invoke Perl, using a statement like $ Perl == "$dev:[dir]Perl.Exe" @@ -296,7 +302,7 @@ internals, you might want to subscribe to the perl5-porters mailing list. You can do this by sending a message to perl5-porters-request@nicoh.com, containing the single line subscribe perl5-porters -This is a moderately high-volume list at the moment (25-50 messages/day). +This is a high-volume list at the moment (>50 messages/day). If you're interested in ongoing information about the VMS port, you can subscribe to the VMSperl mailing list by sending a request to @@ -335,8 +341,6 @@ missed someone. That said, special thanks are due to the following: for the getredirection() code Rich Salz for readdir() and related routines - Denis Haskin - for work on a pod-to-hlp translator for the Perl documentation Richard Dyson and Kent Covert for additional testing on the AXP.