Commit | Line | Data |
ea3bceb2 |
1 | If you read this file _as_is_, just ignore the funny characters you see. |
2 | It is written in the POD format (see pod/perlpod.pod) which is specially |
3 | designed to be readable as is. |
4 | |
5 | =head1 NAME |
6 | |
7 | README.tru64 - Perl version 5 on Tru64 (formerly known as Digital UNIX formerly known as DEC OSF/1) systems |
8 | |
9 | =head1 DESCRIPTION |
10 | |
11 | This document describes various features of Compaq's (formerly Digital's) |
12 | Unix operating system (Tru64) that will affect how Perl version 5 |
13 | is compiled and/or runs. |
14 | |
15 | =head2 Compiling Perl 5 on Tru64 |
16 | |
17 | The recommended compiler to use in Tru64 is the native C compiler. |
8fa7f367 |
18 | The native compiler produces much faster code (the speed difference |
19 | is noticeable: several dozen percentages) and also more correct code: |
20 | if you are considering using the GNU C compiler you should use the |
21 | gcc 2.95.3 since all older gcc releases are known to produce broken |
22 | code when compiling Perl. One manifestation of this brokenness is |
23 | the lib/sdbm test dumping core; another is the op/regexp dumping core |
24 | (depending on the GCC release). |
ea3bceb2 |
25 | |
26 | =head2 Using Large Files with Perl on Tru64 |
27 | |
28 | In Tru64 Perl is automatically able to use large files, that is, files |
29 | larger than 2 gigabytes, there is no need to use the Configure |
30 | -Duselargefiles option as described in INSTALL. |
31 | |
32 | =head2 Threaded Perl on Tru64 |
33 | |
34 | To compile Perl to use the old Perl 5.005 threads model, run Configure |
35 | with the -Dusethreads -Duse5005threads options as described in INSTALL. |
36 | This will probably only work in Tru64 4.0 and newer releases, older |
37 | operating releases like 3.2 aren't probably going to work properly |
38 | with threads. |
39 | |
40 | Beware: the Perl 5.005 threads model is known to have bugs, for |
41 | example the regular expressions are not thread-safe. The bugs are |
42 | very hard to fix are and therefore the 5.005 threads model is still |
43 | classified as an experimental feature. |
44 | |
45 | =head2 64-bit Perl on Tru64 |
46 | |
47 | In Tru64 Perl's integers are automatically 64-bit wide, there is |
48 | no need to use the Configure -Duse64bitint option as described |
49 | in INSTALL. Similarly, there is no need for -Duse64bitall. |
50 | |
51 | =head2 Warnings about floating-point overflow when compiling Perl on Tru64 |
52 | |
53 | When compiling Perl in Tru64 you may (depending on the compiler |
54 | release) see two warnings like this |
55 | |
56 | cc: Warning: util.c, line 3797: In this statement, floating-point overflow occurs in evaluating the expression "1.8e308". (floatoverfl) |
57 | return HUGE_VAL; |
58 | -----------^ |
59 | |
60 | cc: Warning: POSIX.xs, line 1304: In this statement, floating-point overflow occurs in evaluating the expression "1.8e308". (floatoverfl) |
61 | return HUGE_VAL; |
62 | -------------------^ |
63 | |
64 | The exact line numbers may vary between Perl releases. |
65 | The warnings are benign and can be ignored. |
66 | |
67 | When the file F<pp_sys.c> is being compiled you may (depending on the |
68 | operating system release) see an additional compiler flag being used: |
69 | C<-DNO_EFF_ONLY_OK>. This is normal and refers to a feature that is |
70 | relevant only if you use the C<filetest> pragma. In older releases of |
71 | the operating system the feature was broken and the NO_EFF_ONLY_OK |
72 | instructs Perl not to use the feature. |
73 | |
74 | =head1 Testing Perl on Tru64 |
75 | |
76 | During "make test" the C<comp/cpp> will be skipped because on Tru64 it |
77 | cannot be tested before Perl has been installed. The test refers to |
78 | the use of the C<-P> option of Perl. |
79 | |
80 | =head1 AUTHOR |
81 | |
82 | Jarkko Hietaniemi <jhi@iki.fi> |
83 | |
84 | =cut |