This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
use $ENV{LIB} to search for libs under Visual C compiler
[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
95We still got a few errors during 'make test'. Most of them are the
96result of using bison. Bison prints 'parser error' instead of 'syntax
97error', so we may ignore them. One error in the test op/regexp (and
98op/regexp_noamp) seems a bit critical, the result was an 'Out of
99memory' (core dump with op/regexp_noamp). The following list shows
100our errors, your results may differ:
101
a1a0e61e
TD
102op/misc.............FAILED tests 45-46
103op/pack.............FAILED tests 58-60
93fb2ac3
JH
104op/regexp...........FAILED tests 405-492 (core dump)
105op/regexp_noamp.....FAILED tests 405-492 (core dump)
a1a0e61e
TD
106pragma/overload.....FAILED tests 152-153, 170-171
107pragma/subs.........FAILED tests 1-2
93fb2ac3 108pragma/warning......FAILED tests 121, 127, 130, 142
a1a0e61e
TD
109lib/cgi-html........dubious, FAILED tests 1-17 (ALL)
110lib/complex.........FAILED tests 264, 484
111lib/dumper..........FAILED tests MANY
93fb2ac3 112Failed 7/190 test scripts, 96.32% okay. 234/6549 subtests failed, 96.43% okay.
a1a0e61e
TD
113
114
115INSTALLING:
116===========
117
118We have no nroff on BS2000 POSIX (yet), so we ignored any errors while
119installing the documentation.
120
121
122USING PERL:
123===========
124
125BS2000 POSIX doesn't support the shebang notation
126('#!/usr/local/bin/perl'), so you have to use the following lines
127instead:
128
129: # use perl
130 eval 'exec /usr/local/bin/perl -S $0 ${1+"$@"}'
131 if $running_under_some_shell;