X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/46ff39aa3cae6c7727297dc4bbc5eda0da9c5616..4ee329b3000cfabea3246d7ff8a5cb2511455807:/README.vos?ds=sidebyside diff --git a/README.vos b/README.vos index c758235..2283fc1 100644 --- a/README.vos +++ b/README.vos @@ -13,31 +13,38 @@ operating system. Perl is a scripting or macro language that is popular on many systems. See L for a number of good books on Perl. -These are instructions for building Perl from source. Most -people can simply download a pre-compiled distribution from the -VOS anonymous FTP site. This version of Perl is not supported -on VOS Release 14.2.0 or earlier releases. 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 +These are instructions for building Perl from source. This version of +Perl is not supported on VOS Release 14.2 or earlier releases. If you +have a Continuum platform running VOS Release 14.3 through 14.7, +download Perl from the Stratus Anonymous FTP site at +ftp://ftp.stratus.com/pub/vos/posix/ga/continuum/continuum.html. If +you have a V Series platform running VOS Release 15.0 or later, or if +you have a V Series platform running OpenVOS Release 17.0 or later, +download Perl from +ftp://ftp.stratus.com/pub/vos/posix/ga/v-series/v-series.html. The +perl distribution files on the Stratus anonymous FTP site are stored +in a format called a "bundled file". Instructions for unbundling the +Perl distribution file are at 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 -of the VOS GNU C++ and GNU Tools product from Stratus -Technologies. +(or later) of the VOS GNU C/C++ and GNU Tools product from +Stratus Technologies. =head1 BUILDING PERL FOR VOS -To build perl from its source code, you must have a Continuum -platform running VOS Release 14.5.0 or later, the STCP product, -and the GNU C++ and GNU Tools, Release 2.0.1 or later. +To build perl from its source code on the Stratus Continuum +platform, you must be have VOS Release 14.5.0 or later, the STCP +product, and the GNU C/C++ and GNU Tools, Release 2.0.1 or +later. On the V Series platform you must have VOS Release +15.0.0 or later, and any version of the GNU C/C++ and GNU Tools +product. To build full perl using the supplied Configure script and makefiles, change to the "vos" subdirectory and type the command "compile_full_perl" or "start_process compile_full_perl". This -will configure, build, and test perl. All of the test cases -that are executed should pass. +will configure, build, and test perl. =head1 INSTALLING PERL IN VOS @@ -46,35 +53,35 @@ that are executed should pass. =item 1 If you have built perl using the Configure script, ensure that -you have modify permission to C<< >system>ported >> and type +you have modify and default write permission to C<< +>system>ported >> and all subdirectories. Then type gmake install =item 2 -While there are currently no architecture-specific -extensions or modules distributed with perl, the following -directories can be used to hold such files: +While there are currently no architecture-specific extensions or +modules distributed with perl, the following directories can be +used to hold such files (replace the string VERSION by the +appropriate version number): - >system>ported>lib>perl5>5.9.0>68k - >system>ported>lib>perl5>5.9.0>860 - >system>ported>lib>perl5>5.9.0>7100 - >system>ported>lib>perl5>5.9.0>8000 + >system>ported>lib>perl5>VERSION>7100 + >system>ported>lib>perl5>VERSION>8000 + >system>ported>lib>perl5>VERSION>i786 =item 3 Site-specific perl extensions and modules can be installed in one of two places. Put architecture-independent files into: - >system>ported>lib>perl5>site_perl>5.9.0 + >system>ported>lib>perl5>site_perl>VERSION Put site-specific architecture-dependent files into one of the following directories: - >system>ported>lib>perl5>site_perl>5.9.0>68k - >system>ported>lib>perl5>site_perl>5.9.0>860 - >system>ported>lib>perl5>site_perl>5.9.0>7100 - >system>ported>lib>perl5>site_perl>5.9.0>8000 + >system>ported>lib>perl5>site_perl>VERSION>7100 + >system>ported>lib>perl5>site_perl>VERSION>8000 + >system>ported>lib>perl5>site_perl>VERSION>i786 =item 4 @@ -113,24 +120,31 @@ modified to perform such mapping in software on VOS. Performing other floating-point computations that underflow or overflow will probably result in SIGFPE. Don't push your luck. -As of VOS Release 14.7.0, the VOS POSIX runtime sets up the -PA-RISC hardware floating-point status register so that the -overflow and underflow exceptions do not trap, but instead -automatically convert the result to infinity or zero, as +As of VOS Release 14.7.0 or later, the VOS POSIX runtime sets up +the PA-RISC and IA-32 hardware floating-point status register so +that the overflow and underflow exceptions do not trap, but +instead automatically convert the result to infinity or zero, as appropriate. As of this writing, there are still floating-point operations that can trap, for example, subtracting two infinite -values. This is recorded as suggestion posix-1022, which is not -yet fixed. +values. This is recorded as suggestion posix-1022, which has +been fixed in VOS Release 15.2 and higher. =head1 TEST STATUS -When Perl 5.8.1 is built using the native build process on VOS -Release 14.5.0 and GNU C++/GNU Tools 2.0.1, all but five +When Perl 5.9.0 is built using the native build process on VOS +Release 14.7.0 and GNU C++/GNU Tools 2.0.2a, all but nine attempted tests either pass or result in TODO (ignored) failures. The tests that fail are: -ext/Time/HiRes/HiRes, tests 8, 11, 20, and 21. -lib/Net/Ping/t/450_service, test 8. +t/io/dup, test 2 +t/io/tell, test 28 +t/op/pack, test 0 +ext/B/t/bytecode, test 1 +ext/Devel/Peek/t/Peek, test 1 +ext/Encode/t/enc_module, test 1 +ext/IO/t/io_dup, test 2 +lib/ExtUtils/t/MM_Unix, test 94 +lib/Net/ing/t/450_service, test 8 =head1 SUPPORT STATUS @@ -139,10 +153,10 @@ can't guarantee I'll be able to answer them. There are some excellent books available on the Perl language; consult a book seller. -If you want a supported version of perl for VOS, purchase the VOS -GNU C++ and GNU Tools Release 2.0.1 product from Stratus -Technologies, along with a support contract (or from anyone else -who will sell you support). +If you want a supported version of perl for VOS, purchase the +VOS GNU C/C++ and GNU Tools Release 2.0.1 (or later) product from +Stratus Technologies, along with a support contract (or from +anyone else who will sell you support). =head1 AUTHOR @@ -150,6 +164,6 @@ Paul Green (Paul.Green@stratus.com) =head1 LAST UPDATE -March 26, 2003 +October 6, 2010 =cut