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 vttest, 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 vttest, 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, VTTEST.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 VTTEST.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.  Vttest can run
        from the build directory.  You must define a foreign command to
        run vttest (otherwise it won't get command-line arguments).

        The build scripts can generate a script VTTEST.COM which you can
        execute, defining a foreign command that lets you run vttest,
        e.g.,

                $ @VMSBUILD VTTEST_COM
                $ @VTTEST -P -L

        or

                $ MMS VTTEST.COM
                $ @VTTEST -P -L

	Vttest is a menu-driven program.  Version 1.7 was been used for
	several years in the UNIX environment for testing VT100 terminal
	implementations.  This new version (2.7 20041107) runs on VAX/VMS
	as well.  It assumes (but does not require) that you know something
	about the VT100 terminology.

Installing:
----------
        You can install the executable for vttest 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.,

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

        if you put it in your home directory.

--

Thomas Dickey (dickey@herndon4.his.com)
