--- gcc/INSTALL	2018/04/24 16:43:47	1.1.1.4
+++ gcc/INSTALL	2018/04/24 16:46:40	1.1.1.7
@@ -1,10 +1,12 @@
-This is a copy of one node from the Info file internals-1.
+This is a copy of one node from the Info file gcc.info-1.
 For full information on installing and porting GCC, refer to the
-internals manual:
+GCC manual:
 
-  Info file   internals
-  TeX output  internals.dvi
-  TeX source  internals.texinfo
+  Info file   gcc.info
+  TeX output  gcc.dvi
+  TeX source  gcc.texinfo
+
+File: gcc.info,  Node: Installation,  Next: Trouble,  Prev: Options,  Up: Top
 
 Installing GNU CC
 *****************
@@ -21,7 +23,12 @@ Here is the procedure for installing GNU
 
   2. On a Sequent system, go to the Berkeley universe.
 
-  3. Choose configuration files.
+  3. Choose configuration files.  The easy way to do this is to run
+     the command file `config.gcc' with a single argument, which is
+     the name of the machine as it appears in the `tm-MACHINE.h' file
+     name.
+
+     Here we spell out what files you need to set up:
 
         * Make a symbolic link named `config.h' to the top-level
           config file for the machine you are using (*note
@@ -41,7 +48,7 @@ Here is the procedure for installing GNU
                for Intel 80386's running system V.
 
          `config-sun4.h'
-               for Suns (model 3 or 4) running *operating system*
+               for Suns (model 2, 3 or 4) running *operating system*
                version 4.
 
          `config-hp9k3.h'
@@ -90,7 +97,9 @@ Here is the procedure for installing GNU
           For the vax, use `tm-vax.h' on BSD Unix, `tm-vaxv.h' on
           system V, or `tm-vms.h' on VMS.
 
-          For the SPARC (Sun 4), use `tm-sparc.h'.
+          For the SPARC (Sun 4), use `tm-sparc.h'.  Note that SPARC
+          support currenty *does not work*.  It will probably be
+          fixed for version 1.31.
 
           For the Motorola 88000, use `tm-m88k.h'.  The support for
           the 88000 has a few unfinished spots because there was no
@@ -114,7 +123,9 @@ Here is the procedure for installing GNU
           Note that Encore systems are supported only under BSD.
 
         * Make a symbolic link named `md' to the machine description
-          pattern file (its name should be `MACHINE.md').
+          pattern file.  Its name should be `MACHINE.md', but MACHINE
+          is often not the same as the name used in the `tm.h' file
+          because the `md' files are more general.
 
         * Make a symbolic link named `aux-output.c' to the output
           subroutine file for your machine (its name should be
@@ -125,9 +136,8 @@ Here is the procedure for installing GNU
      `cexp.c' are more recent than `c-parse.y' and `cexp.y' and you
      do not plan to change the `.y' files.)
 
-     Note that if you have an old version of Bison you may get an
-     error from the line with the `%expect' directive.  If so, simply
-     remove that line from `c-parse.y' and proceed.
+     Bison versions older that Sept 8, 1988 will produce incorrect
+     output for `c-parse.tab.c'.
 
   5. If you are using a Sun, make sure the environment variable
      `FLOAT_OPTION' is not set.  If this option were set to `f68881'
@@ -137,6 +147,12 @@ Here is the procedure for installing GNU
 
   6. Build the compiler.  Just type `make' in the compiler directory.
 
+     Ignore any warnings you may see about ``statement not reached''
+     in the `insn-emit.c'; they are normal.  Any other compilation
+     errors may represent bugs in the port to your machine or
+     operating system, and should be investigated and reported (*note
+     Bugs::.).
+
   7. Move the first-stage object files and executables into a
      subdirectory with this command:
 
@@ -160,7 +176,7 @@ Here is the procedure for installing GNU
      more time, do this:
 
           make stage2
-          Make CC=stage2/gcc CFLAGS="-g -O -Bstage2/"
+          make CC=stage2/gcc CFLAGS="-g -O -Bstage2/"
           foreach file (*.o)
           cmp $file stage2/$file
           end
@@ -208,10 +224,10 @@ Here is the procedure for installing GNU
      correct the include files by running the shell script
      `fixincludes'.  This installs modified, corrected copies of the
      files `ioctl.h', `ttychars.h' and many others, in a special
-     directory where only GNU CC will normally look for them.
-
-     See the file `fixincludes' for a list of all the files we know
-     to require correction.
+     directory where only GNU CC will normally look for them.  This
+     script will work on various systems because it choose the files
+     by searching all the system headers for the problem cases that
+     we know about.
 
 If you cannot install the compiler's passes and run-time support in
 `/usr/local/lib', you can alternatively use the `-B' option to
@@ -225,7 +241,7 @@ files by setting the Make variable `libd
 
 
 
-File: internals,  Node: VMS Install,  Prev: Installation,  Up: Installation
+File: gcc.info,  Node: VMS Install,  Prev: Installation,  Up: Installation
 
 Installing GNU CC on VMS
 ========================