T U R B O M A C R O S
version 2.3


Copyright (c) 1988 by Jason J. Roberts.
ALL RIGHTS RESERVED.




INTRODUCTION:

Do you ever get sick of typing "writeln("? Do you think that typing "begin" and
"end" so much is a waste of time? Turbo Macros is a program designed to
increase the efficiency of programming in Turbo Pascal 4.0. It is a Terminate
Stay Resident (TSR) program that assigns 20 unused function key combinations to
your favorite keystroke sequences -- "readln", "integer", or whatever. Each
macro may be up to 10 characters long! Turbo Macros' function key definitions
may be changed, but a set of commonly used ones are provided with the program.



LICENSE AGREEMENT:
Anyone may use or copy Turbo Macros, but only under the following conditions:
Turbo Macros must be distributed in absolutely unmodified form, including ALL
program, documentation, and other files. Turbo Macros may not be included with
any other product for any reason whatsoever. No charge or payment of any kind
may be levied or accepted for Turbo Macros. Distributors of User Supported,
Shareware, and Public Domain software MUST obtain written permission from the
author, Jason J. Roberts, before distributing Turbo Macros and must follow the
above conditions.



DISCLAIMER:

The author makes no warranties, expressed or implied, for this software. In
addition, the author will not be liable for ANY damages, indirect,
consequential, or otherwise, arising from the use of Turbo Macros.



USING TURBO MACROS:

To run Turbo Macros, just type "turbomac". The screen will clear, and the
license agreement will pop up, and you will be returned to DOS. Turbo Macros
should now be ready for use. The keys that Turbo Macros uses are "Alt 1"
through "Alt 0", "Ctrl F1" through "Ctrl F10", "Alt P", and "Alt D". "Alt P"
will print the file in the Turbo Editor, so long as you have SAVED the file
PREVIOUS to hitting "Alt P". "Alt D" will remove the macros from memory, but
not delete the PROGRAM from memory. (I'm currently working on this.) Here is a
listing of the function keys and their default macros:

Key Macro Key Macro
======================== =========================
Alt 1 "BEGIN" Ctrl F1 "FOR "
Alt 2 "END" Ctrl F2 "WHILE "
Alt 3 "Write(" Ctrl F3 "DO"
Alt 4 "WriteLn(" Ctrl F4 "REPEAT"
Alt 5 "Read(" Ctrl F5 "UNTIL "
Alt 6 "ReadLn(" Ctrl F6 "BOOLEAN"
Alt 7 "FUNCTION " Ctrl F7 "CHAR"
Alt 8 "PROCEDURE " Ctrl F8 "INTEGER"
Alt 9 "IF " Ctrl F9 "REAL"
Alt 0 "THEN " Ctrl F10 "STRING"



COMMAND LINE OPTIONS [c, d, h, r]:

To change the function key definitions, run Turbo Macros with the "change"
option. (Type "turbomac c".) You will be shown a function key and its current
definition, and be asked to enter the new definition. To keep the current
definition, just press return.

The "display" option will display the current macro definitions on the screen.
(Type "turbomac d".)

"h" is the "help" option. Help will display a listing of the command line
options. (Type "turbomac h".)

To reset the macro definitions, you must use the "reset" option. (Type
"turbomac r".) This will reset all of the macros to their default definitions.



IMPORTANT NOTES:

The file "turbomac.key" MUST be in the same directory that "turbomac.exe" is
in. "turbomac.key" is the file containing the function key definitions.
Pathing will not work. If you get an error, there is a 99% probability that
either you are calling Turbo Macros through a path, or this file is missing. If
you get this error, and you can't figure out why, running Turbo Macros with the
"reset" option (see above) should fix it. Resetting the macros will create a
new macro definition file, if the old one is missing.

If you want to run Turbo Macros, you MUST exit completely from Turbo Pascal.
THIS PROGRAM MAY DO NASTY THINGS IF RUN FROM INSIDE A DOS SHELL! A good idea is
to run Turbo Macros BEFORE you run Turbo Pascal.

Turbo Macros should not overwrite another macro program. For example, you can
still call up Sidekick, even if you have already loaded Turbo Macros into
memory.



REVISION HISTORY:

Version 1.0 -- original release, 20 preset function keys.
Version 1.1 -- "Alt P" function key added for printing.
Version 2.0 -- "change" option added.
Version 2.1 -- "display macros" and "reset macros" options added.
Version 2.2 -- "help" option added.
Version 2.3 -- "Alt D" function key added.