This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
integrate cfgperl changes#6293..6324 into mainline
[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
93fb2ac3
JH
53generate a pure (=reentrant) parser for perly.y. So our yacc is
54really the following script:
a1a0e61e 55
93fb2ac3
JH
56-----8<-----/usr/local/bin/yacc-----8<-----
57#! /usr/bin/sh
a1a0e61e 58
93fb2ac3
JH
59# Bison as a reentrant yacc:
60
61# save parameters:
62params=""
63while [[ $# -gt 1 ]]; do
64 params="$params $1"
65 shift
66done
67
68# add flag %pure_parser:
69
70tmpfile=/tmp/bison.$$.y
71echo %pure_parser > $tmpfile
72cat $1 >> $tmpfile
73
74# call bison:
75
76echo "/usr/local/bin/bison --yacc $params $1\t\t\t(Pure Parser)"
77/usr/local/bin/bison --yacc $params $tmpfile
78
79# cleanup:
80
81rm -f $tmpfile
82-----8<----------8<-----
83
84We still use the normal yacc for a2p.y though!!! We made a softlink
85called byacc to distinguish between the two versions:
86
87ln -s /usr/bin/yacc /usr/local/bin/byacc
d5047e56 88
93fb2ac3 89We build perl using both GNU make and the native make.
a1a0e61e
TD
90
91
92TESTING:
93========
94
c8e8bf6a 95We still got a few errors during 'make test'. Some of them are the
a1a0e61e 96result of using bison. Bison prints 'parser error' instead of 'syntax
c8e8bf6a 97error', so we may ignore them. The following list shows
a1a0e61e
TD
98our errors, your results may differ:
99
c8e8bf6a
GS
100op/numconvert.......FAILED tests 1409-1440
101op/regexp...........FAILED tests 483, 496
102op/regexp_noamp.....FAILED tests 483, 496
a1a0e61e 103pragma/overload.....FAILED tests 152-153, 170-171
c8e8bf6a
GS
104pragma/warnings.....FAILED tests 14, 82, 129, 155, 192, 205, 207
105lib/bigfloat........FAILED tests 351-352, 355
106lib/bigfltpm........FAILED tests 354-355, 358
107lib/complex.........FAILED tests 267, 487
108lib/dumper..........FAILED tests 43, 45
109Failed 11/231 test scripts, 95.24% okay. 57/10595 subtests failed, 99.46% okay.
a1a0e61e
TD
110
111INSTALLING:
112===========
113
114We have no nroff on BS2000 POSIX (yet), so we ignored any errors while
115installing the documentation.
116
117
118USING PERL:
119===========
120
121BS2000 POSIX doesn't support the shebang notation
122('#!/usr/local/bin/perl'), so you have to use the following lines
123instead:
124
125: # use perl
126 eval 'exec /usr/local/bin/perl -S $0 ${1+"$@"}'
127 if $running_under_some_shell;