Contents of the TCCMENU.DOC file

TCCMENU v1.01 11/21/88

By: Jim Derr Copyright (c) 1988

o Association of Shareware o Professionals

MEMBER

LIMIT OF LIABILITY

TCCMENU is distributed as-is. The author disclaims all warranties, expressed or implied. The author will assume no liability for damages either from the direct use of this product or as a consequence of the use of this product.

TurboC is a product of Borland International.

WHAT IS TCCMENU

TCCMENU was written to make using the command line TurboC compiler eaiser to use. With TCCMENU you can create, save, and recall, as many different configurations to start up the TurboC compiler as you wish. You can then invoke the TurboC compiler at the press of a key.

USING TCCMENU

When TCCMENU is started for the first time a panel is displayed showing TCCMENU'S internal default values. You may change any of the values you wish by moving the cursor to the appropriate field and entering the appropriate option. When all your options are set pressing the F3 key will save all of the options into a file with a name that you control. (Please note TCCMENU does not edit the options that are entered. If they are enter incorrectly they are save incorrectly). To compile a program move the cursor to the field entitled PROGRAMS TO COMPILE and type in the names of the programs and OBJ and LIBS files you wish to compile and/or link. Press the F5 key and TCCMENU will build a TURBOC.CFG file and will invoke the TurboC command line compiler.

You may also specify options on the command line when invoking TCCMENU. The format is:

TCCMENU [/Cconfig-file-name] ["list-of-pgms-to-compile"] [/R]

The /C option allows you to specify a configuration file to load and use. (This must be a configuration file that was created via TCCMENU)

A list of programs to compile may also be passed if there is more that one program enclose the file names in double quotes.

The /R options tells TCCMENU not to display its screen but to immediately invoke the TurboC compiler.

EXAMPLES:

TCCMENU /Cmy.xfg "hello.c" /R This will compile program hello.c using the configuration information stored in the file my.xfg and will immediately invoke the compiler.

TCCMENU /Cmy.xfg "hello.c" /R > hello.lst This does at stated above but will redirect all output from the compiler into a file called hello.lst.

TCCMENU hello.c > hello.lst This will cause TCCMENU to display it's screen but will place hello.c into the PROGRAMS TO COMPILE field on the screen. When you invoke the compiler via the F5 key all output will be redirected into file hello.lst.

If you create a configuration file named DEFAULT.XFG TCCMENU will use the information contained in the configuration file instead of it's own internal defaults.

When using the F2, load configuration file, or the command line option /C TCCMENU, please note if you do not provide a file extension TCCMENU will append .XFG to the file name specified. I.E. If you enter TCCMENU /Cmine TCCMENU will attempt to load the configuration file named MINE.XFG.

FUNCTION KEY ASSIGNMENTS

F1 = HELP This will display a panel showing all possible configuration switches.

F2 = Load a configuration file.

F3 = SAVE current configuration information into a file.

F4 = Pop up a list of tccmenu configuation file to load. (Note TCCMENU configuration files must have an extension of .XFG to be found by this option.)

F5 = Invoke the TurboC compiler.

F9 = Move the cursor to the opposite side of the screen.

F10 = EXIT

ESC = EXIT

ENVIRONMENT VARIABLES

TCCMENU will recognize the following environment variables if they are set: BIOS This will force TCCMENU to use BIOS for writting to the screen. MONO This will force TCCMENU to run in monochrome mode.

Examples: SET BIOS=Y SET MONO=Y

COMPATIBILITY ISSUES TCCMENU achives fast screen updates buy writing directly to video buffer memory. If your machine is not 100% compatible you can force TCCMENU to use BIOS routines to update the screen. This is accomplished by setting an environment variable BIOS equal to Y. I.E. SET BIOS=Y. Do this before executing sharc.

For monochrome monitors a similar method is employed set the environment variable MONO equal to Y. I.E. SET MONO=Y.

As usual any and all comments are welcome. If there are some features that are missing, drop me a note and I'll try to accommodate you if I think the feature is generally useful.

Additional Stuff

I have spent many hours on this program trying to make it as easy to use as possible and reasonably fast. I have also tried to be responsive to user comments and requests. Also note that the program is not crippled in any way. It is a fully functional program.