For this cdrom, I tested/updated using accounts provided by Charles
Sandman and Jerry Leslie (VAX with OpenVMS 7.1), as well as the HP Test-Drive
machines (Alpha with OpenVMS 7.3, IA64 with E8.2).

For other system configurations, to run byacc, you'll need a C compiler
(I've tested with VAX-C and DEC-C).  It's nice but not essential to have
MMS (or its clone, MMK).

Building without MMS:
--------------------

        If you simply want to build byacc, run the script:

                $ @VMSBUILD

        The build-scripts attempt to determine your compiler
        configuration:

                VMS with VAX-C
                VMS with DEC-C on a VAX
                VMS with DEC-C on an Alpha
                VMS with DEC-C on an IA64

        The result of the build is an executable, YACC.EXE
	Some people install that as BYACC.EXE

Building with MMS:
-----------------

        The source distribution includes DESCRIP.MMS, which is the MMS
        script.  Run MMS in the source directory; it'll find this file
        and compile/link YACC.EXE, e.g.,

                $ MMS

        I've only used MMK installed as a foreign command; it doesn't
        work well with the recursive macros set in DESCRIP.MMS, in the
        "all" target.

        The standard targets in the MMS script are:  "all", "clean",
        clobber".

Running the program:
-------------------

        You don't have to install the program to run it.  Yacc can run
        from the build directory.  You must define a foreign command to
        run byacc (otherwise it won't get command-line arguments).

Installing:
----------
        You can install the executable for byacc in the directory where
        you normally install user programs or tools.  Define (e.g., in
        your LOGIN.COM) the foreign command to point to it, e.g.,

                $ YACC :== "$ SYS$LOGIN:YACC.EXE"

        if you put it in your home directory.

--

Thomas Dickey (dickey@invisible-island.net)