summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorAndy Dougherty <doughera@lafcol.lafayette.edu>1997-03-30 11:44:30 +1200
committerChip Salzenberg <chip@atlantic.net>1997-04-03 10:03:25 +1200
commit203c3eeca2516d7ec08a0618594a5440ce517675 (patch)
tree7592b0e60edc142506269e622953b02a7fafff4e /INSTALL
parent544a35660dae17ef1feb6a04b0ee237bb0d8dcc1 (diff)
downloadperl-203c3eeca2516d7ec08a0618594a5440ce517675.tar.gz
Update INSTALL
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL49
1 files changed, 34 insertions, 15 deletions
diff --git a/INSTALL b/INSTALL
index 6d88548a01..451c6da37b 100644
--- a/INSTALL
+++ b/INSTALL
@@ -43,6 +43,10 @@ If you're building Perl on a non-Unix system, you should also read
the README file specific to your operating system, since this may
provide additional or different instructions for building Perl.
+If there is a hint file for your system (in the hints/ directory) you
+should also read that hint file for specific information for your
+system. (Unixware users should use the svr4.sh hint file.)
+
=head1 Space Requirements
The complete perl5 source tree takes up about 7 MB of disk space. The
@@ -88,7 +92,8 @@ Configure interactively rather than blindly accepting the defaults.
Configure will figure out various things about your system. Some
things Configure will figure out for itself, other things it will ask
you about. To accept the default, just press RETURN. The default
-is almost always ok.
+is almost always ok. At any Configure prompt, you can type &-d
+and Configure will use the defaults from then on.
After it runs, Configure will perform variable substitution on all the
*.SH files and offer to run make depend.
@@ -104,11 +109,6 @@ compiler) so that the hints files can set appropriate defaults.
If you want to use your old config.sh but override some of the items
with command line options, you need to use B<Configure -O>.
-If you are willing to accept all the defaults, and you want terse
-output, you can run
-
- sh Configure -des
-
By default, for most systems, perl will be installed in
/usr/local/{bin, lib, man}. You can specify a different 'prefix' for
the default installation directory, when Configure prompts you or by
@@ -127,6 +127,15 @@ your system supports it. If you want to force perl to be compiled
statically, you can either choose this when Configure prompts you or
you can use the Configure command line option -Uusedl.
+If you are willing to accept all the defaults, and you want terse
+output, you can run
+
+ sh Configure -des
+
+For my Solaris system, I usually use
+
+ sh Configure -Dprefix=/opt/perl -Doptimize='-xpentium -xO4' -des
+
=head2 GNU-style configure
If you prefer the GNU-style configure command line interface, you can
@@ -702,15 +711,20 @@ you probably want to do
sh Configure -Doptimize='-g'
-This will do two things: First, it will force compilation to use
-cc -g so that you can use your system's debugger on the executable.
-Second, it will add a -DDEBUGGING to your ccflags variable in
+This will do two independent things: First, it will force compilation
+to use cc -g so that you can use your system's debugger on the
+executable. (Note: Your system may actually require something like
+cc -g2. Check you man pages for cc(1) and also any hint file for your
+system.) Second, it will add -DDEBUGGING to your ccflags variable in
config.sh so that you can use B<perl -D> to access perl's internal
-state. Note, however, that Configure will only add -DDEBUGGING by
+state. (Note: Configure will only add -DDEBUGGING by
default if you are not reusing your old config.sh. If you want to
reuse your old config.sh, then you can just edit it and change the
optimize and ccflags variables by hand and then propagate your changes
-as shown in L<"Propagating your changes to config.sh"> below.
+as shown in L<"Propagating your changes to config.sh"> below.)
+
+You can actually specify -g and -DDEBUGGING independently, but usually
+it's convenient to have both.
If you are using a shared libperl, see the warnings about multiple
versions of perl under L<Building a shared libperl.so Perl library>.
@@ -728,9 +742,14 @@ following:
sh Configure -Dccflags='-Drand=random -Dsrand=srandom'
-or by adding -Drand=random and -Dsrandom=srandom to your ccflags
-at the appropriate Configure prompt. (You may also have to adjust
-Configure's guess for 'randbits' as well.)
+or by adding -Drand=random and -Dsrand=srandom to your ccflags
+at the appropriate Configure prompt. (Note: Although this worked for
+me, it might not work for you if your system's header files give
+different prototypes for rand() and random() or srand() and srandom().)
+
+You should also run Configure interactively to verify that a hint file
+doesn't inadvertently override your ccflags setting. (Hints files
+shouldn't do that, but some might.)
=head2 What if it doesn't work?
@@ -1359,4 +1378,4 @@ feedback from the perl5-porters@perl.org folks.
=head1 LAST MODIFIED
-$Id: INSTALL,v 1.11 1997/03/26 19:08:06 doughera Released $
+$Id: INSTALL,v 1.13 1997/04/03 18:29:14 doughera Released $