     This directory contains the sources for the "compiler driver" program
that implements the GCC command for VMS.  The driver operates in two steps:
1) an image (GCC.EXE) retrieves and processes the command line using DCL's
parsing routines, then exits using lib$do_command() to pass control to
2) a DCL command procedure (GCC.COM) which runs the various programs
(preprocessor, language-specific compiler, assembler) that comprise the
full compiler.  This driver does not use any of "specs" files that the
normal gcc driver program supports.


MANIFEST        -- this file, describing the gcc-src/vms directory contents
COPYING		-- a copy of the GNU Public License
ChangeLog       -- record of significant changes
build_gcc.com   -- DCL command procedure to compile & link the driver program
gcc.c           -- source code for the first half of the driver program
gcc.cld         -- command definition for GCC
gcc.dcl         -- DCL source for the second half of the driver program
gcc.rnh         -- DSR ("Runoff") source for the driver's documentation
gcc_ivp.dcl     -- DCL source for the installation validation procedure
gcc_startup.dcl -- DCL source for the boot-time setup procedure
gcclib/         -- subdirectory containing source for the support library


Miscellaneous notes:

     build_gcc.com compiles gcc.c plus gcc.cld and links them as gcc.exe;
it also processes gcc.rnh into gcc.hlp, the VMS help library entry.
gcc.cld is intended to update DCLTABLES in addition to being compiled
into gcc.exe.  *.dcl get copied as-is into gnu_cc:[000000]*.com when
the latter directory is being put together; gcc.cld is copied there too.
File gnu_cc:[000000]gcclib.olb is built from the sources in the gcclib
subdirectory here, then augmented with the contents of libgcc2.olb
(which is created when building the latest compiler; ie, along with
gcc-cc1 from the gcc source distribution).


Some orphan files:

     The bison-src/vms directory doesn't contain enough to warrant its
own documentation.  Bison is not needed to _use_ GNU C, just to build it.

bison.com       -- command procedure to define BISON as a DCL command
bison_startup.dcl -- DCL source for the boot-time setup procedure

     Bison doesn't contain support for a foreign command interface with
bison.cld compiled in, so bison.com provides a way to set up the native
command interface "at need" for users at sites that have chosen not to
install the command system-wide.  As above, *.dcl is copied to *.com
when the public directory is produced.

