This is the VMS-GCC directory structure.  It contains the executables,
include files and gcclib object library required to compile C programs.

Following is information extracted from the GCC.INFO-2 documentation
from the source code distribution for GCC:

======Begin extract from GCC.INFO-2
To install the `GCC' command so you can use the compiler easily, in
the same manner as you use the VMS C compiler, you must install the
VMS CLD file for GNU CC as follows:

  1. Define the VMS logical names `GNU_CC' and `GNU_CC_INCLUDE' to
     point to the directories where the GNU CC executables
     (`gcc-cpp', `gcc-cc1', etc.) and the C include files are kept. 
     This should be done with the commands:

          $ assign /super /system disk:[gcc] gnu_cc
          $ assign /super /system disk:[gcc.include] gnu_cc_include

     with the appropriate disk and directory names.  These commands
     can be placed in your system startup file so they will be
     executed whenever the machine is rebooted.

[Editor's note:  PLEASE SEE THE NOTE FOLLOWING THIS EXTRACTED SECTION]


  2. Install the `GCC' command with the command line:

          $ set command /table=sys$library:dcltables gnu_cc:gcc

     Now you can invoke the compiler with a command like `gcc
     /verbose file.c', which is equivalent to the command `gcc -v -c
     file.c' in Unix.

There is a known problem on VMS: `const' global variables don't work
compatibly with the VMS C compiler; we don't know a way to get them
to the linker properly.
======End extract from GCC.INFO-2

NOTE: 
The better way of handling the logicals mentioned in number 1 above
is to use the GCC_INSTALL.COM procedure as well as the INSTALL_BISON.COM
procedure.  The source distribution GCC.INFO-2 has not yet been updated
to reflect the existence of these command procedures under VMS.
The correct statements for your system startup file:

    $ @disk:[directory]INSTALL_BISON.COM
    $ @disk:[directory]GCC_INSTALL.COM

Additionally, the source distribution does not mention the BISON.CLD
file in this directory.  You should set this as a command using:

    $ set command /table=sys$library:dcltables gnu_cc:bison

However, BISON is not essential for running the gcc compiler.  You would
only need it to build a version from sources, or to use it in your own
work.  It is similar to YACC on unix systems (Yet Another Compiler Compiler).


Larry Deni
Systems Programmer/DBA
Canisius College
Buffalo, NY 14208
BITNET:  deni@canisius