PERL 5.000
==========


Compilation DomainOS 10.4:
--------------------------

cd ~/proj
mkdir perl; cd perl

tar xzf perl5*.tar.gz
cd perl5*0

# source patch:
# Apollo cc (bsd) generates wrong code for this particular switch statment
# (see perl5.000.fix1).
*** pp_ctl.c~   Tue Oct 18 00:13:48 1994
--- pp_ctl.c    Fri Apr 21 18:29:38 1995
***************
*** 166,171 ****
--- 166,172 ----
      double value;
      bool gotsome;
      STRLEN len;
+     U16 tmpval;
  
      if (!SvCOMPILED(form)) {
        SvREADONLY_off(form);
***************
*** 209,215 ****
            else
                fprintf(stderr, "%-16s\n", name);
        } )
!       switch (*fpc++) {
        case FF_LINEMARK:
            linemark = t;
            formmark = f;
--- 210,218 ----
            else
                fprintf(stderr, "%-16s\n", name);
        } )
!       tmpval = *fpc++;
!       switch ( tmpval ) {
! 
        case FF_LINEMARK:
            linemark = t;
            formmark = f;

# patch it with

patch -s <../perl5.000.fix1




# there are 2 variants:
#	BSD				without POSIX extension
#					2 tests are failing because they need
#					the POSIX module
#	BSD + SYS5 FAKED HEADER		with POSIX extension, the exec. is 130K
#					larger
#
# All extension are statically linked to the perl executable.
#
# The compilation should be done in the BSD4.3 environment.
#

--------------------------------- BSD ------------------------------------
./Configure


##### change follwoing options:

# equivalent to -W0,-opt,3
What optimizer/debugger flag should be used? [-O2]  

Any additional cc flags? [-A cpu,mathchip]  

What is the file extension used for shared libraries? [none]  

# Don't use nm extraction. With nm extractino Configure would try to
# investigate 2 libraries, but the script is only able to handle one path.
# Even with one path not all really available symbols are found by Configure.
# So we use here the C compiler variant to be sure that all symbols are catched.
Shall I use nm to extract C symbols from the libraries? [y] n
 
# The Configure script interprets "/lib/clib /lib/libc" as one path ->
# so use only one of the given (I think this in actually not used if nm
# extraction is suppressed).

Where is your C library? [/lib/clib /lib/libc] /lib/libc

Directory /usr/local/lib/perl5/apollo doesn't exist.  Use that name anyway? [n] y

# break the script with ^C (there is a question where you'll be asked for it) and
# edit config.sh:

useposix='false'
# and remove ODBM and POSIX from the extension lists, because:
#	POSIX need the missing /usr/include/sys/utsname.h and
#	fcntl.h is not complete,
#	ODBM needs the function dbmclose which is not provided by the Apollo libs.

# make.noposix.log
(Configure -S; make depend; make) >& make.noposix.log &

cp -p perl perl.noposix


# test results:

make test

        AutoSplitting perl library

        Making DynaLoader (static)

        Making Fcntl (static)

        Making NDBM_File (static)

        Making SDBM_File (static)
         cd t && chmod +x TEST */*.t
         cd t && (rm -f perl; /bin/ln -s ../perl perl) && ./perl TEST </dev/tty
base/cond......ok
base/if........ok
base/lex.......ok
base/pat.......ok
base/term......ok
comp/cmdopt....ok
comp/cpp.......ok
comp/decl......ok
comp/multiline.ok
comp/package...ok
comp/script....ok
comp/term......ok
cmd/elsif......ok
cmd/for........ok
cmd/mod........ok
cmd/subval.....ok
cmd/switch.....ok
cmd/while......ok
io/argv........ok
io/dup.........ok
io/fs..........ok
io/inplace.....ok
io/pipe........ok
io/print.......ok
io/tell........ok
op/append......ok
op/array.......ok
op/auto........ok
op/chop........ok
op/cond........ok
op/delete......ok
op/do..........ok
op/each........ok
op/eval........ok
op/exec........ok
op/exp.........ok
op/flip........ok
op/fork........ok
op/glob........ok
op/goto........ok
op/groups......ok
op/index.......ok
op/int.........ok
op/join........ok
op/list........ok
op/local.......ok
op/magic.......ok
op/misc........PROG: -P
 
use POSIX;
EXPECTED:

GOT:
Can't locate POSIX.pm in @INC at - line 2.
BEGIN failed--compilation aborted at - line 2.
FAILED on test 3
op/mkdir.......ok
op/my..........ok
op/oct.........ok
op/ord.........ok
op/pack........ok
op/pat.........ok
op/push........ok
op/quotemeta...ok
op/rand........ok
op/range.......ok
op/read........ok
op/readdir.....ok
op/ref.........ok
op/regexp......ok
op/repeat......ok
op/sleep.......ok
op/sort........ok
op/split.......ok
op/sprintf.....ok
op/stat........ok
op/study.......ok
op/subst.......ok
op/substr......ok
op/time........ok
op/undef.......ok
op/unshift.....ok
op/vec.........ok
op/write.......ok
lib/anydbm.....ok
lib/bigint.....ok
lib/db-btree...ok
lib/db-hash....ok
lib/db-recno...ok
lib/english....ok
lib/gdbm.......ok
lib/ndbm.......ok
lib/odbm.......ok
lib/posix......1..0
FAILED on test 0
lib/sdbm.......ok
lib/soundex....ok
Failed 2/88 tests, 97.73% okay.
*** Error code 2 (ignored)

--------------------------------- END BSD ------------------------------------


-------------------------------- BSD + SYS5 FAKED HEADER ----------------------------------

# We use here a small trick: We build up (*) a header file tree consisting of
# symbolic links to the original headerfiles of the BSD environment.
# Missing and uncomplete header file are brought into the tree by copying them
# from the SYS5 environment. Configure is informed to use this new tree
# instead of /usr/include (see config.sh_posix as reference).
#
# (*) The tree is automatically build by using the csh-script
# 'makeincludedir'. The complete tree is available as perl5_includes.tar.gz
#

# creates a directory 'inc' which should be used instead of /usr/include,
# it contains all necessary links to the SYS5 environment and patched
# header files
../makeincludedir


# use a hand modified config.sh (with the changed include file path)
cp ../config.sh_posix config.sh

# make.posix.log
(Configure -S; make depend; make) >& make.posix.log &
cp -p perl perl.posix


# test results:

make test

        AutoSplitting perl library

        Making DynaLoader (static)

        Making Fcntl (static)

        Making NDBM_File (static)

        Making POSIX (static)

        Making SDBM_File (static)
         cd t && chmod +x TEST */*.t
         cd t && (rm -f perl; /bin/ln -s ../perl perl) && ./perl TEST </dev/tty
base/cond......ok
base/if........ok
base/lex.......ok
base/pat.......ok
base/term......ok
comp/cmdopt....ok
comp/cpp.......ok
comp/decl......ok
comp/multiline.ok
comp/package...ok
comp/script....ok
comp/term......ok
cmd/elsif......ok
cmd/for........ok
cmd/mod........ok
cmd/subval.....ok
cmd/switch.....ok
cmd/while......ok
io/argv........ok
io/dup.........ok
io/fs..........ok
io/inplace.....ok
io/pipe........ok
io/print.......ok
io/tell........ok
op/append......ok
op/array.......ok
op/auto........ok
op/chop........ok
op/cond........ok
op/delete......ok
op/do..........ok
op/each........ok
op/eval........ok
op/exec........ok
op/exp.........ok
op/flip........ok
op/fork........ok
op/glob........ok
op/goto........ok
op/groups......ok
op/index.......ok
op/int.........ok
op/join........ok
op/list........ok
op/local.......ok
op/magic.......ok
op/misc........ok
op/mkdir.......ok
op/my..........ok
op/oct.........ok
op/ord.........ok
op/pack........ok
op/pat.........ok
op/push........ok
op/quotemeta...ok
op/rand........ok
op/range.......ok
op/read........ok
op/readdir.....ok
op/ref.........ok
op/regexp......ok
op/repeat......ok
op/sleep.......ok
op/sort........ok
op/split.......ok
op/sprintf.....ok
op/stat........ok
op/study.......ok
op/subst.......ok
op/substr......ok
op/time........ok
op/undef.......ok
op/unshift.....ok
op/vec.........ok
op/write.......ok
lib/anydbm.....ok
lib/bigint.....ok
lib/db-btree...ok
lib/db-hash....ok
lib/db-recno...ok
lib/english....ok
lib/gdbm.......ok
lib/ndbm.......ok
lib/odbm.......ok
lib/posix......ok
lib/sdbm.......ok
lib/soundex....ok
All tests successful.
u=1.88333  s=5.3  cu=44.45  cs=29.05  files=88  tests=1580

--------------------------------- END BSD + SYS5 FAKED HEADER ------------------------------------

# automatic rebuild without user interaction (using an previous generated
# config.sh)

( Configure -der ; make ) > & make.log &


# or announce a changed config.sh to all relevant subdirs

Configure -S
make depend >& make.log &
make >>&make.log &

# the last one but as background job

(Configure -S; make depend; make) >& make.log &




# test perl

make test

# or

chmod +x t/TEST t/*/*.t; ln -s ../perl t/perl
(cd t; ./perl TEST </dev/tty)




Installation DomainOS 10.4:
---------------------------


# for each node

make install

# or
./perl installperl

# wrong name of link: correct the version number
mv /usr/local/bin/perl0.000 /usr/local/bin/perl5.000

make install

# or
./perl installperl

# wrong name of link: correct the version number
mv /usr/local/bin/perl0.000 /usr/local/bin/perl5.000

# create perl includes (assuming the perl source has been expanded into
# ~jk/proj/perl) using the faked include files

sed 's|/usr/include|//newton/ABT/USER/vta/jk/proj/perl/perl5.000/inc|g' h2ph >h2ph.new
(cd //newton/ABT/USER/vta/jk/proj/perl/perl5.000/inc; //newton/ABT/USER/vta/jk/proj/perl/perl5.000/h2ph.new * sys/*)

# or the original header files (perl without POSIX)
(cd /usr/include; ~jk/proj/perl/perl5*0/h2ph * sys/*)


# optionally install not automatically installed man pages and execs

install -c -m 644 h2ph.man /usr/local/man/man1/h2ph.1
install -c -m 755 h2ph /usr/local/bin

# remove old manpages (if desired)

/bin/rm -f /usr/local/man/mann/{s2p,a2p,h2ph,perl}.n

# man pages are shared among other hosts

# make real local executable to prevent netpaging of the perl exec.

foreach n (//*)
if (-d $n/sys/node_data) then
 cp -p /usr/local/bin/perl $n/usr/local/lbin && strip $n/usr/local/lbin/perl
 ln -s /usr/local/lbin/perl $n/usr/bin
 if (! -d $n/usr/local/lib/perl5) ln -s //`hostname`/usr/local/lib/perl5 $n/usr/local/lib/perl5
endif
end

# make 2nd real copy of the perl5-library tree

(cd //aa/usr/local/lib; mv perl5 perl5.link)
cd /usr/local/lib
tar cf - perl5 | (cd //aa/usr/local/lib; tar xpfB -)


# html docs
mkdir ../Http
cd pod
make html

# directory for http access
mv *.html ../../Http/