From: John L. Allen <allen@grumman.com>
Date: Thu, 29 Jul 1999 14:55:05 +0000 (-0400)
Subject: Update README and INSTALL; partly based on the message
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=491517e03c6a5df5aef649456de95bc218ced051;p=p5sagit%2Fp5-mst-13.2.git

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
--- 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
--- 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.