Commit | Line | Data |
---|---|---|
ea3bceb2 JH |
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 JH |
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 JH |
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 | ||
bef5f079 JH |
45 | =head2 Long Doubles on Tru64 |
46 | ||
47 | You cannot Configure Perl to use long doubles unless you have at least | |
48 | Tru64 V5.0, the long double support simply wasn't functional before | |
49 | that. | |
50 | ||
ea3bceb2 JH |
51 | =head2 64-bit Perl on Tru64 |
52 | ||
53 | In Tru64 Perl's integers are automatically 64-bit wide, there is | |
54 | no need to use the Configure -Duse64bitint option as described | |
55 | in INSTALL. Similarly, there is no need for -Duse64bitall. | |
56 | ||
57 | =head2 Warnings about floating-point overflow when compiling Perl on Tru64 | |
58 | ||
59 | When compiling Perl in Tru64 you may (depending on the compiler | |
60 | release) see two warnings like this | |
61 | ||
d780cd7a | 62 | cc: Warning: numeric.c, line 104: In this statement, floating-point overflow occurs in evaluating the expression "1.8e308". (floatoverfl) |
ea3bceb2 JH |
63 | return HUGE_VAL; |
64 | -----------^ | |
65 | ||
66 | cc: Warning: POSIX.xs, line 1304: In this statement, floating-point overflow occurs in evaluating the expression "1.8e308". (floatoverfl) | |
67 | return HUGE_VAL; | |
68 | -------------------^ | |
69 | ||
70 | The exact line numbers may vary between Perl releases. | |
71 | The warnings are benign and can be ignored. | |
72 | ||
73 | When the file F<pp_sys.c> is being compiled you may (depending on the | |
74 | operating system release) see an additional compiler flag being used: | |
75 | C<-DNO_EFF_ONLY_OK>. This is normal and refers to a feature that is | |
76 | relevant only if you use the C<filetest> pragma. In older releases of | |
77 | the operating system the feature was broken and the NO_EFF_ONLY_OK | |
78 | instructs Perl not to use the feature. | |
79 | ||
80 | =head1 Testing Perl on Tru64 | |
81 | ||
82 | During "make test" the C<comp/cpp> will be skipped because on Tru64 it | |
83 | cannot be tested before Perl has been installed. The test refers to | |
84 | the use of the C<-P> option of Perl. | |
85 | ||
86 | =head1 AUTHOR | |
87 | ||
88 | Jarkko Hietaniemi <jhi@iki.fi> | |
89 | ||
90 | =cut |