Commit | Line | Data |
8d063cd8 |
1 | |
a687059c |
2 | Perl Kit, Version 3.0 |
8d063cd8 |
3 | |
21d892ea |
4 | Copyright (c) 1989,1990, Larry Wall |
a687059c |
5 | |
6 | This program is free software; you can redistribute it and/or modify |
7 | it under the terms of the GNU General Public License as published by |
8 | the Free Software Foundation; either version 1, or (at your option) |
9 | any later version. |
10 | |
11 | This program is distributed in the hope that it will be useful, |
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
14 | GNU General Public License for more details. |
15 | |
16 | You should have received a copy of the GNU General Public License |
17 | along with this program; if not, write to the Free Software |
18 | Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
8d063cd8 |
19 | |
8d063cd8 |
20 | -------------------------------------------------------------------------- |
21 | |
22 | Perl is a language that combines some of the features of C, sed, awk and shell. |
23 | See the manual page for more hype. |
24 | |
25 | Perl will probably not run on machines with a small address space. |
26 | |
27 | Please read all the directions below before you proceed any further, and |
a687059c |
28 | then follow them carefully. |
8d063cd8 |
29 | |
30 | After you have unpacked your kit, you should have all the files listed |
31 | in MANIFEST. |
32 | |
33 | Installation |
34 | |
35 | 1) Run Configure. This will figure out various things about your system. |
36 | Some things Configure will figure out for itself, other things it will |
37 | ask you about. It will then proceed to make config.h, config.sh, and |
38 | Makefile. |
39 | |
40 | You might possibly have to trim # comments from the front of Configure |
41 | if your sh doesn't handle them, but all other # comments will be taken |
42 | care of. |
43 | |
44 | (If you don't have sh, you'll have to copy the sample file config.H to |
45 | config.h and edit the config.h to reflect your system's peculiarities.) |
46 | |
47 | 2) Glance through config.h to make sure system dependencies are correct. |
48 | Most of them should have been taken care of by running the Configure script. |
49 | |
50 | If you have any additional changes to make to the C definitions, they |
51 | can be done in the Makefile, or in config.h. Bear in mind that they will |
52 | get undone next time you run Configure. |
53 | |
54 | 3) make depend |
55 | |
56 | This will look for all the includes and modify Makefile accordingly. |
57 | Configure will offer to do this for you. |
58 | |
59 | 4) make |
60 | |
61 | This will attempt to make perl in the current directory. |
62 | |
d8f2e4cc |
63 | If you can't compile successfully, try adding a -DCRIPPLED_CC flag. |
64 | (Just because you get no errors doesn't mean it compiled right!) |
65 | This simplifies some complicated expressions for compilers that |
66 | get indigestion easily. If that has no effect, try turning off |
67 | optimization. If you have missing routines, you probably need to |
68 | add some library or other, or you need to undefine some feature that |
69 | Configure thought was there but is defective or incomplete. |
70 | |
71 | Some compilers will not compile or optimize the larger files without |
72 | some extra switches to use larger jump offsets or allocate larger |
73 | internal tables. It's okay to insert rules for specific files into |
74 | Makefile.SH, since a default rule only take effect in the |
75 | absence of a specific rule. |
76 | |
77 | The 3b2 needs to turn off -O. |
78 | AIX/RT may need a -a switch and -DCRIPPLED_CC. |
21d892ea |
79 | SUNOS 4.0.[12] needs #define fputs(str,fp) fprintf(fp,"%s",str) in perl.h |
d8f2e4cc |
80 | SGI machines may need -Ddouble="long float". |
81 | Ultrix (2.3) may need to hand assemble teval.s with a -J switch. |
449aadca |
82 | Ultrix on MIPS machines may need -DLANGUAGE_C. |
d8f2e4cc |
83 | SCO Xenix may need -m25000 for yacc. |
ff2452de |
84 | Xenix 386 needs -Sm10000 for yacc. |
d8f2e4cc |
85 | Genix needs to use libc rather than libc_s, or #undef VARARGS. |
449aadca |
86 | NCR Tower 32 (OS 2.01.01) may need -W2,-Sl,2000 and #undef MKDIR. |
87 | Machines with half-implemented dbm routines will need to #undef ODBM & NDBM. |
88 | C's that don't try to restore registers on longjmp() may need -DJMPCLOBBER. |
89 | (Try this if you get random glitches.) |
d8f2e4cc |
90 | |
8d063cd8 |
91 | 5) make test |
92 | |
93 | This will run the regression tests on the perl you just made. |
94 | If it doesn't say "All tests successful" then something went wrong. |
378cc40b |
95 | See the README in the t subdirectory. Note that you can't run it |
03a14243 |
96 | in background if this disables opening of /dev/tty. If "make test" |
97 | bombs out, just cd to the t directory and run TEST by hand to see if |
98 | it makes any difference. |
8d063cd8 |
99 | |
100 | 6) make install |
101 | |
a687059c |
102 | This will put perl into a public directory (such as /usr/local/bin). |
8d063cd8 |
103 | It will also try to put the man pages in a reasonable place. It will not |
104 | nroff the man page, however. You may need to be root to do this. If |
105 | you are not root, you must own the directories in question and you should |
106 | ignore any messages about chown not working. |
107 | |
108 | 7) Read the manual entry before running perl. |
109 | |
a687059c |
110 | 8) IMPORTANT! Help save the world! Communicate any problems and suggested |
8d063cd8 |
111 | patches to me, lwall@jpl-devvax.jpl.nasa.gov (Larry Wall), so we can |
112 | keep the world in sync. If you have a problem, there's someone else |
113 | out there who either has had or will have the same problem. |
114 | |
115 | If possible, send in patches such that the patch program will apply them. |
116 | Context diffs are the best, then normal diffs. Don't send ed scripts-- |
117 | I've probably changed my copy since the version you have. |
118 | |
d8f2e4cc |
119 | Watch for perl patches in comp.lang.perl. Patches will generally be |
8d063cd8 |
120 | in a form usable by the patch program. If you are just now bringing up |
121 | perl and aren't sure how many patches there are, write to me and I'll |
122 | send any you don't have. Your current patch level is shown in patchlevel.h. |
123 | |
a687059c |
124 | |
125 | Just a personal note: I want you to know that I create nice things like this |
126 | because it pleases the Author of my story. If this bothers you, then your |
127 | notion of Authorship needs some revision. But you can use perl anyway. :-) |
128 | |
129 | The author. |