Added descriptions to tests lacking them.
[perl.git] / README.dgux
1 If you read this file _as_is_, just ignore the funny characters you
2 see. It is written in the POD format (see perlpod manpage) which is
3 specially designed to be readable as is.
4
5 =head1 NAME
6
7 perldgux - Perl under DG/UX.
8
9 =head1 SYNOPSIS
10
11 One can read this document in the following formats:
12
13         man perldgux
14         view perl perldgux
15         explorer perldgux.html
16         info perldgux
17
18 to list some (not all may be available simultaneously), or it may
19 be read I<as is>: as F<README.dgux>.
20
21 =cut
22
23 Contents
24
25  perldgux - Perl under DG/UX.
26
27       NAME
28       SYNOPSIS
29       DESCRIPTION
30       BUILD
31          -  Non-threaded Case
32          -  Threaded Case
33          -  Testing
34          -  Installing the built perl
35       AUTHOR
36       SEE ALSO
37
38 =head1 DESCRIPTION
39
40 Perl 5.7/8.x for DG/UX ix86 R4.20MU0x
41
42 =head1 BUILDING PERL ON DG/UX
43
44 =head2 Non-threaded Perl on DG/UX
45
46 Just run ./Configure script from the top directory.
47 Then give "make" to compile.
48
49 =head2 Threaded Perl on DG/UX
50
51 If you are using as compiler GCC-2.95.x rev(DG/UX)
52 an easy solution for configuring perl in your DG/UX
53 machine is to run the command:
54
55 ./Configure -Dusethreads -Duseithreads -Dusedevel -des
56
57 This will automatically accept all the defaults and
58 in particular /usr/local/ as installation directory.
59 Note that GCC-2.95.x rev(DG/UX) knows the switch
60 -pthread which allows it to link correctly DG/UX's
61 -lthread library.
62
63 If you want to change the installation directory or
64 have a standard DG/UX with C compiler GCC-2.7.2.x
65 then you have no choice than to do an interactive
66 build by issuing the command:
67
68 ./Configure -Dusethreads -Duseithreads
69
70 In particular with GCC-2.7.2.x accept all the defaults
71 and *watch* out for the message:
72
73     Any additional ld flags (NOT including libraries)? [ -pthread]
74
75 Instead of -pthread put here -lthread. CGCC-2.7.2.x
76 that comes with the DG/UX OS does NOT know the -pthread
77 switch. So your build will fail if you choose the defaults.
78 After configuration is done correctly give "make" to compile.
79
80 =head2 Testing Perl on DG/UX
81
82 Issuing a "make test" will run all the tests. 
83 If the test lib/ftmp-security gives you as a result
84 something like
85
86     lib/ftmp-security....File::Temp::_gettemp:
87     Parent directory (/tmp/) is not safe (sticky bit not set
88     when world writable?) at lib/ftmp-security.t line 100
89
90 don't panic and just set the sticky bit in your /tmp
91 directory by doing the following as root:
92
93 cd /
94 chmod +t /tmp (=set the sticky bit to /tmp).
95
96 Then rerun the tests. This time all must be OK.
97
98 =head2 Installing the built perl on DG/UX
99
100 Run the command "make install"
101
102 =head1 AUTHOR
103
104 Takis Psarogiannakopoulos
105 University of Cambridge
106 Centre for Mathematical Sciences
107 Department of Pure Mathematics
108 Wilberforce road
109 Cambridge CB3 0WB , UK
110 email <takis@XFree86.Org>
111
112 =head1 SEE ALSO
113
114 perl(1).
115
116 =cut
117