Update README and INSTALL; partly based on the message

To: Jarkko Hietaniemi <jhi@iki.fi>
cc: perl5-porters@perl.org
Subject: Re: Perl Installation Problem
Message-ID: <Pine.SOL.3.91.990729144440.1035A-100000@gateway.grumman.com>

and private email from Andy Dougherty.

p4raw-id: //depot/cfgperl@3900

diff --git a/INSTALL b/INSTALL
index c2953b8..4647002 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -7,7 +7,7 @@ Install - Build and Installation guide for perl5.
 The basic steps to build and install perl5 on a Unix system are:
 
        rm -f config.sh Policy.sh
-       sh Configure
+       sh Configure -de
        make
        make test
        make install
@@ -19,6 +19,17 @@ The basic steps to build and install perl5 on a Unix system are:
 
 Each of these is explained in further detail below.
 
+The above commands will install Perl to /usr/local or /opt, depending
+on the platform.  If that's not okay with you, use
+
+       rm -f config.sh Policy.sh
+       sh Configure
+       make
+       make test
+       make install
+
+Full configuration instructions can be found in the INSTALL file.
+
 For information on non-Unix systems, see the section on
 L<"Porting information"> below.
 
@@ -1119,12 +1130,17 @@ libgdbm under HP-UX 11.
 Specific information for the OS/2, Plan9, VMS and Win32 ports is in the
 corresponding README files and subdirectories.  Additional information,
 including a glossary of all those config.sh variables, is in the Porting
-subdirectory.
+subdirectory.  Especially Porting/Glossary should come in handy. 
 
 Ports for other systems may also be available.  You should check out
 http://www.perl.com/CPAN/ports for current information on ports to
 various other operating systems.
 
+If you plan to port Perl to a new architecture study carefully the
+section titled "Philosophical Issues in Patching and Porting Perl"
+in the file Porting/pumpkin.pod and the file Porting/patching.pod.
+Study also how other non-UNIX ports have solved problems.
+
 =back
 
 =head1 make depend

diff --git a/README b/README
index e3ccad4..63ae2e3 100644 (file)
--- a/README
+++ b/README
@@ -64,14 +64,27 @@ Installation
 
 1) Detailed instructions are in the file INSTALL which you should read.
 In brief, the following should work on most systems:
-       rm -f config.sh
-       sh Configure
+
+       rm -f config.sh Policy.sh
+       sh Configure -de
        make
        make test
        make install
+
 For most systems, it should be safe to accept all the Configure defaults.
-(It is recommended that you accept the defaults the first time you build
-or if you have any problems building.)
+It is recommended that you accept the defaults the first time you build
+or if you have any problems building.
+
+The above commands will install Perl to /usr/local or /opt, depending
+on the platform.  If that's not okay with you, use
+
+       rm -f config.sh Policy.sh
+       sh Configure
+       make
+       make test
+       make install
+
+Full configuration instructions can be found in the INSTALL file.
 
 2) Read the manual entries before running perl.