This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
POSIX BC2000 port from perl-mvs:
[perl5.git] / README.posix-bc
CommitLineData
a1a0e61e
TD
1This is a first ported perl for the POSIX subsystem in BS2000 VERSION
2'V121', OSD V3.1, POSIX Shell V03.1A55. It may work on other
3versions, but that's the one we've tested it on.
4
5You may need the following GNU programs in order to install perl:
6
7gzip:
8
9We used version 1.2.4, which could be installed out of the box with
10one failure during 'make check'.
11
12bison:
13
14The yacc coming with BS2000 POSIX didn't work for us. So we had to
15use bison. We had to make a few changes to perl in order to use the
16pure (reentrant) parser of bison. We used version 1.25, but we had to
17add a few changes due to EBCDIC.
18
19
20UNPACKING:
21==========
22
23To extract an ASCII tar archive on BS2000 POSIX you need an ASCII
24filesystem (we used the mountpoint /usr/local/ascii for this). Now
25you extract the archive in the ASCII filesystem without I/O-conversion:
26
27cd /usr/local/ascii
28export IO_CONVERSION=NO
29gunzip < /usr/local/src/perl.tar.gz | pax -r
30
31You may ignore the error message for the first element of the archive
32(this doesn't look like a tar archive / skipping to next file...),
33it's only the directory which will be made anyway.
34
35After extracting the archive you copy the whole directory tree to your
36EBCDIC filesystem. This time you use I/O-conversion:
37
38cd /usr/local/src
39IO_CONVERSION=YES
40cp -r /usr/local/ascii/perl5.005_02 ./
41
42
43COMPILING:
44==========
45
46There is a "hints" file for posix-bc that specifies the correct values
47for most things. The major problem is (of course) the EBCDIC character
48set.
49
50Configure did everything except the perl parser.
51
52Because of our problems with the native yacc we used GNU bison to
53generate a pure (=reentrant) parser for perly.y:
54
55echo %pure_parser > /tmp/perly.y
56cat perly.y >> /tmp/perly.y
57/usr/local/bin/bison --yacc -d perly.y
58cp y.tab.c perly.c
59cp y.tab.h perly.h
60
61We build perl using GNU make, but it should compile with the native
62make too.
63
64
65TESTING:
66========
67
68We still got a few errors during 'make test'. Most of them are the
69result of using bison. Bison prints 'parser error' instead of 'syntax
70error', so we may ignore them. One error in the test op/regexp (and
71op/regexp_noamp) seems a bit critical, the result was an 'Out of
72memory' (core dump with op/regexp_noamp). The following list shows
73our errors, your results may differ:
74
75comp/require........FAILED test 3
76op/misc.............FAILED tests 45-46
77op/pack.............FAILED tests 58-60
78op/regexp...........FAILED tests 402-485 (Out of memory!)
79op/regexp_noamp.....FAILED tests 402-485 (core dump)
80op/taint............FAILED test 73
81pragma/overload.....FAILED tests 152-153, 170-171
82pragma/subs.........FAILED tests 1-2
83lib/cgi-html........dubious, FAILED tests 1-17 (ALL)
84lib/complex.........FAILED tests 264, 484
85lib/dumper..........FAILED tests MANY
86lib/errno...........dubious (Errno.pm not found?)
87lib/searchdict......FAILED tests 1-2
88Failed 13/186 test scripts, 93.01% okay. 224/6242 subtests failed, 96.41%
89okay.
90
91
92INSTALLING:
93===========
94
95We have no nroff on BS2000 POSIX (yet), so we ignored any errors while
96installing the documentation.
97
98
99USING PERL:
100===========
101
102BS2000 POSIX doesn't support the shebang notation
103('#!/usr/local/bin/perl'), so you have to use the following lines
104instead:
105
106: # use perl
107 eval 'exec /usr/local/bin/perl -S $0 ${1+"$@"}'
108 if $running_under_some_shell;