🚀 go-pugleaf

Hello,

I recently installed gcc 2.7.2 here at my site. All went well, but I find
that maybe I ought to do a rebuild and install, since the INSTALL file in the
top-level directory of the archive was a little confusing about something.

In my install, I made the stage 1 compiler by running configure, and
then a 'make LANGUAGES=c'. Okay so far.

Then the instructions say to move the stage1 compiler into the stage1
directory by doing a 'make stage1'. Still okay.

We then compile the compiler with itself by doing a
'make CC="stage1/xgcc -Bstage1/" CFLAGS="-g -O2"', as per the instructions
in the INSTALL file. This is the stage 2 compiler.

I elected not to make the stage3 compiler or run the compare, as I have
a Solaris 2 machine which stores the object files in ELF format.

Now, the confusing part. The instructions say:

--- cut ---

 15. Install the compiler driver, the compiler's passes and run-time
     support with `make install'.  Use the same value for `CC',
     `CFLAGS' and `LANGUAGES' that you used when compiling the files
     that are being installed.  One reason this is necessary is that
     some versions of Make have bugs and recompile files gratuitously
     when you do this step.  If you use the same variable values, those
     files will be recompiled properly.
 
     For example, if you have built the stage 2 compiler, you can use
     the following command:
 
        make install CC="stage2/xgcc -Bstage2/" CFLAGS="-g -O" LANGUAGES="LIST"

--- cut ---

1) The options in CFLAGS do not match those of the example for making the
   stage2 compiler. Minor, but they ought to match, IMO, especially since
   there is so much emphasis on using the same values as before.

2) The really confusing thing is that, "if you have built the stage 2
   compiler", it does not follow that the stage2 directory exists. I didn't
   build the stage3 compiler, so there was no reason to do a 'make stage2'.
   There probably ought to be an example for both cases.

3) The LANGUAGES="LIST" threw me off for a bit, too, but I was able to
   figure it out. Perhaps it should say, "...where LIST is the list of
   languages you specified when building the stage 1 compiler."

So, maybe item 15 should be revised to say:

--- cut ---

 15. Install the compiler driver, the compiler's passes and run-time
     support with `make install'.  Use the same value for `CC',
     `CFLAGS' and `LANGUAGES' that you used when compiling the files
     that are being installed.  One reason this is necessary is that
     some versions of Make have bugs and recompile files gratuitously
     when you do this step.  If you use the same variable values, those
     files will be recompiled properly.
 
     For example, if you have built the stage 3 compiler, you can use
     the following command:
 
        make install CC="stage2/xgcc -Bstage2/" CFLAGS="-g -O2" LANGUAGES="LIST"

     If you have only built the stage 2 compiler, then use:

        make install CC="stage1/xgcc -Bstage1/" CFLAGS="-g -O2" LANGUAGES="LIST"

     In both of these examples, "LIST" would be the list of languages you
     specified when building the stage 3 (or 2) compiler. Example: 'LANGUAGES=c'
     If you didn't specify a value for the LANGUAGES keyword when building the
     stage 3 (or 2) compiler, then leave it out now.

--- cut ---

Whaddya think?

--                                  "...and this just in: scientists have
Griff Miller                         isolated the gene that determines whether
Systems Administrator   '95 Z-28     or not one thinks Monty Python is funny."
Positron Corporation    '85 VF1100S
griff.miller@positron.com            My opinions are mine, not Positron's.