Format improvements, mostly for @smallbook (including reformatted table
[deliverable/binutils-gdb.git] / README.configure
index b01596612fba2dca6cd80e48c6d79df350ef12a6..c77813d5db483c0f7c81595dbcdb9e6a6174a7b5 100755 (executable)
@@ -1,20 +1,17 @@
-
-
                   On Configuring Development Tools
 
-        Last Mod Fri May 3 13:02:35 PDT 1991, by rich@sendai
+                       K. Richard Pixley
+                       Cygnus Support
 
+                Last Mod Tue Oct 1 21:20:21 PDT 1991, by rich@cygnus.com
 
 INTRO
 -----
 
     This document attempts to describe the general concepts behind
     configuration of the Cygnus Support release of the GNU Development
-    Tools.  It also discusses common usage.  For a more in succint
-    description, please refer to the man page on "configure" which you
-    should have received {FIXME: ALONG WITH LOTS OF OTHER VERY PRETTY
-    HARD COPY OR IN A DIFFERENT DISTRIBUTION OR ON THIS TAPE OR SHRINK
-    BOX OR SOMETHING}.
+    Tools.  It also discusses common usage.  Eventually, FIXME, there
+    will also be a man page for "configure", an "info" tree, etc.
 
 
 BASICS
@@ -111,20 +108,20 @@ Configuration Time Options:
     structure, the intermediate pieces used in the build process must
     be kept separate.
 
-       ./configure sun4 +forcesubdirs +notation=postfix
-       ./configure sun3 +forcesubdirs +notation=infix
+       ./configure sun4 +subdirs +notation=postfix
+       ./configure sun3 +subdirs +notation=infix
 
     will create subdirectories for the intermediate pieces of the sun4
     and sun3 configurations.  This is necessary as previous systems
     were only capable of one configuration at a time.  A second
     configuration overwrote the first.  We've chosen to retain this
-    behaviour so the "+forcesubdirs" configuration option is necessary
+    behaviour so the "+subdirs" configuration option is necessary
     to get the new behaviour.  The order of the arguments doesn't
     matter.  There should be exactly one argument without a leading
     '+' sign and that argument will be assumed to be the host name.
 
     From here on the examples will assume that you want to build the
-    tools "in place" and won't show the "+forcesubdirs" option, but
+    tools "in place" and won't show the "+subdirs" option, but
     remember that it is available.
 
     In order to actually install the program, the configuration system
@@ -132,9 +129,7 @@ Configuration Time Options:
     default location is /usr/local.  We refer to this location as
     $(destdir).  All user visible programs will be installed in
     $(destdir)/bin.  All other programs and files will be installed in
-    a subdirectory of $(destdir)/lib.  For the tools in this
-    directory, the files not normally user visible will be installed
-    in $(destdir)/lib/gcc.
+    a subdirectory of $(destdir)/lib.
 
     You can elect to change $(destdir) only as a configuration time
     option.
@@ -217,7 +212,7 @@ BUILDING DEVELOPMENT ENVIRONMENTS
     In this example, like before, we create two configurations.  The
     first is intended to be built in a sun4 environment, in
     subdirectories, to be installed in /local.  The second is intended
-    to be build in a sun3 environment, in subdirectories, to be
+    to be built in a sun3 environment, in subdirectories, to be
     installed in /local.
 
     Unlike the previous example, the first configuration will produce
@@ -514,13 +509,6 @@ The Three Party Cross:
 FINAL NOTES
 -----------
 
-Gdb's config has features not yet present in the uniform configuration
-scheme described here.  For this reason, configuration of gdb must
-currently be done separately from that of the rest of this package.
-This will be corrected soon.  For more information on the
-configuration of gdb, please refer to the documents in gdb.{your
-target} if it exists, otherwise gdb.
-
 By "configures", I mean that links, Makefile, .gdbinit, and
 config.status are built.  Configuration is always done from the source
 directory.
@@ -535,12 +523,12 @@ directory.
   hostname and target is targetname.  If a previous configuration
   existed, it will be overwritten.
 
-* "./configure +forcesubdirs hostname +target=targetname" creates a
-  subdirectories Host-hostname and Host-hostname/Target-targetname and
-  configures Host-hostname/Target-targetname.  For now, makes should
-  be done from Host-hostname/Target-targetname.  "./configure +f name"
-  works as expected.  That is, it creates Host-name and
-  Host-name/Target-name and configures the latter.
+* "./configure +subdirs hostname +target=targetname" creates a
+  subdirectories H-hostname and H-hostname/T-targetname and
+  configures H-hostname/T-targetname.  For now, makes should
+  be done from H-hostname/T-targetname.  "./configure +sub name"
+  works as expected.  That is, it creates H-name and
+  H-name/T-name and configures the latter.
 
 
 Hacking configurations:
@@ -558,7 +546,7 @@ the chosen host+target pair and build style, that is, if you use
 subdirectories or not.  The host and target specific Makefile may or
 may not exist.  If fragments
 
-* Makefiles can be editted directly, but those changes will eventually
+* Makefiles can be edited directly, but those changes will eventually
   be lost.  Changes intended to be permanent for a specific host
   should be made to the host specific Makefile fragment.  This should
   be in ./config/hmake-host if it exists.  Changes intended to be
@@ -569,14 +557,14 @@ may not exist.  If fragments
   these, either use "make Makefile" or re-configure from the source
   directory.
 
-* configure can be editted directly, but those changes will eventually
+* configure can be edited directly, but those changes will eventually
   be lost.  Changes intended to be permanent for a specific directory
   should be made to configure.in.  Changes intended to be permanent
   for all configure scripts should be made to configure.template.
   Propogating changes to configure.in requires the presence of
   configure.template which normally resides in the uppermost directory
   you received.  To propogate changes to either configure.template or
-  a configure.in, use "configure +template=absolutepathtothetemplate".
+  a configure.in, use "configure +template=pathtothetemplate".
   This will configure the configure scripts themselves, recursively if
   appropriate.
 
This page took 0.025573 seconds and 4 git commands to generate.