Document the behaviour of filetest operators regarding parentheses.
[p5sagit/p5-mst-13.2.git] / README.uts
CommitLineData
91144103 1If you read this file _as_is_, just ignore the funny characters you
2see. It is written in the POD format (see perlpod manpage) which is
3specially designed to be readable as is.
4
5=head1 NAME
6
7perluts - Perl under UTS
8
9=head1 SYNOPSIS
10
11This document can be read I<as is>: as F<README.uts>, or you
12can read it after you build your package using "man perluts".
13
14The purpose is to help you build Perl for UTS, which, if you
15follow these instructions, should be easy, and result in
16a solidly working installation.
17
18=head1 DESCRIPTION
19
20Perl 5.7.2 (Developmental) or Perl 5.8.x (forthcoming) for UTS
21
22=head1 BUILDING PERL ON UTS
23
24NOTE: Some sites have redefined the way uname works, and if yours
25does this, special steps must be taken so that Configure can
26recognize your system as a UTS system. To see if you are in
27this category, issue the command "uname -a". It should look
28something like:
29
30 uts juno 4 4.4 9672 370
31
32At any rate, the first field should be "uts". If this is not
33the case; supposing it is, say telcoUTS, create a script, uts/uname
34(i.e. uname, in the subdirectory "uts" of the main Perl source dir):
35 # uname
36 /usr/bin/uname "$@" | sed -e 's/^telcoUTS/uts/'
37
38and when you execute Configure, do it as below, except for adding
39PATH=uts:$PATH as a prefix. I.e. do:
40
41 PATH=uts:$PATH ./Configure ...
42
43There is no need to do an interactive configure, just type
44
45 ./Configure -de [-Dusedevel] [-Doptimize=-g ] 2>&1 | tee Conf.out
46
47"-Dusedevel" may be required to configure Perl 5.7.2 non-interactively.
48Use -Doptimize=-g if you want to run Perl under sdb or gdb, OR
49if you want to be able to use the -D command line flags to perl,
50which are occasionally useful in debugging perl scripts.
51
52In this and the following steps, the "2>&1 | tee XXX.out" records all
53output from the process, which will be useful if anything unexpected
54goes wrong.
55
56Then do the compilation with
57
58 make 2>&1 | tee make.out
59
60Finally, test using
61
62 make test 2>&1 | tee make-test.out
63
64In the output, the only failures you should see should look like:
65
66 lib/Math/BigInt/t/bigfltpm.........Use of uninitialized value ...
67 FAILED at test 57
68 lib/Math/BigInt/t/bigintc..........ok
69 lib/Math/BigInt/t/bigintpm.........FAILED at test 204
70 lib/Math/BigInt/t/mbimbf...........Use of uninitialized value ...
71 Illegal division by zero at ../lib/Math/BigInt/Calc.pm line 314.
72 FAILED at test 71
73 lib/Math/Complex...................exp: OVERFLOW
74 FAILED at test 250
75 lib/Math/Trig......................exp: OVERFLOW
76 ok
77 lib/Memoize/t/array................ok
78 ...
79 lib/Net/protoent...................ok
80 lib/Net/servent....................FAILED at test 0
81
82This means that everything passes except for some problems in the
83packages "Math::BigInt", "Math::Complex", and "Math::Trig".
84The lib/Net/servent failure seems to be a bug in the test
85program. To confirm this, from the main Perl source dir, do:
86
87 LD_LIBRARY_PATH=`pwd` ./perl -Ilib lib/Net/servent.t
88
89and it should output
90
91 1..3
92 ok 1
93 ok 2
94 ok 3
95
96=head1 Installing the built perl on UTS
97
98Run the command "make install"
99
100=head1 AUTHOR
101
102 Hal Morris
103 UTS Global LLC
104 email: hom00@utsglobal.com
105
106=cut
107