Black Box 4

home *** CD-ROM | disk | FTP | other *** search

/ Black Box 4 / BlackBox.cdr / dosutils / toddy4.arj / TODDY.DOC < prev

Wrap

Text File | 1991-09-03 | 47.7 KB | 1,011 lines

Toddy A DOS Command Line Editor by Eric Tauck 1304 Deerpass Road Marengo, IL 60152 U.S.A Compuserve: 72457,1557 Internet: 72457.1557@compuserve.com CircuitNet: Software Conference Toddy is a terminate and stay resident (TSR) utility that im- proves the entry and editing of DOS commands, saves commands for later retrieval, and provides resident macros that work like simple batch files. Only certain programs that use DOS for input, like COMMAND.COM or DEBUG.COM, will be affected by Toddy. Toddy will work on any PC compatible running DOS 2.0 or greater. Toddy may be used and distributed freely. The most recent ver- sion of the Toddy is available on 5.25" or 3.5" disk by sending $10 to the address above. The WASM compatible source code is available for $25. The source code is for personal use and may not be distributed. DISCLAIMER OF WARRANTY THIS SOFTWARE AND MANUAL ARE DISTRIBUTED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. GOOD DATA PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH NON-CRITICAL DATA BEFORE RELYING ON IT. THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM. ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE. Installation ------------ Toddy is installed by running it from the command line. The features of Toddy are available upon installation. Toddy is usually installed from the AUTOEXEC.BAT file when the computer is booted up. If you get the message "Multiplex number in use by another program" when you try to install Toddy, see the /M switch described in the Switch Descriptions section. Toddy uses a minimum of 3456 bytes of memory, and 4048 bytes in it's default configuration. The memory consumption increases according to the size of the command history (/HS) and macro data areas (/MS and /MN). If you don't use the command history, you can conserve memory by setting the history size to zero (/HS0). If you don't use macros, you can conserve memory by setting the macro table size and macro nest to zero (/MS0 and /MN0 respec- tively). The total bytes used by the /HS and /MS must be less than about 54000. The appearance of Toddy (i.e. the colors and cursor types) can be set with the /AT, /AC, /AE, /TE, /TI, /TO, /TX, /TC, and /TC switches. By default, Toddy sets all the attributes (colors) to 7 and does not modify the cursor type. Macros can be loaded before or after installation. Macros can be loaded automatically as part of the TODDY.COM file, loaded from a separate text file, or defined on the command line when Toddy is installed. Once installed, Toddy may be disabled with the /D switch and enabled with the /E switch. These switches might be useful if an application seems to conflict with Toddy. Toddy may also be removed from memory with the uninstall switch (/U). The end of this document contains a list of version changes and some additional notes on using and configuring Toddy. Editing ------- Toddy's enhanced editing commands are available immediately upon installation. When entering a DOS command, the right and left arrow keys can be used to move the cursor non-destructively. Past commands can be retrieved by pressing the up and down arrow keys, or by typing a few letters and searching for a matching command with the Tab key. You can quickly and easily enter the name of an existing file by typing part of the name and pressing F9 until the entire name is displayed. The standard DOS editing keys may also be used. In the next table and throughout the rest of this document, a "Ctrl-" to the immediate left of a keystroke or letter refers to that keystroke pressed with the CONTROL key held down. Similar- ly, an "Alt-" next to a keystroke refers to the keystroke pressed with the ALT key held down. A complete list of editing commands follows: Left move cursor left Right move cursor right Home move cursor to first column End move cursor to last column Ctrl-Left move cursor to previous word Ctrl-Right move cursor to next word Delete delete character under the cursor Backspace delete character to the left of the cursor Ctrl-Backspace delete word to the left of the cursor Ctrl-Home delete all characters left of the cursor Ctrl-End delete all characters right of the cursor Escape delete all characters on the line Up older history line PgUp oldest history line Down newer history line PgDn newest history line (last line saved) Tab search for matching history line Alt-F7 delete all history lines F9 replace field with matching file name F10 replace/append field with matching file name Enter accept input Ctrl-Enter accept input without any processing Insert toggle insert mode Ctrl-L delete word to the left of the cursor Ctrl-R delete word to the right of the cursor Ctrl-D delete current history line Ctrl-K copy current line to history then clear line Ctrl-V enter a control character F1 copy next character from the template F2 copy template characters up to the next key F3 copy remaining characters from the template F4 skip template characters up to the next key F5 copy current input to the template F6 insert EOF character To enter control characters normally interpreted by DOS or Toddy, press Ctrl-V and then the letter. For instance, press Ctrl-VC to enter Ctrl-C. Besides the control keys listed above (Ctrl-L, Ctrl-R, Ctrl-D, Ctrl-K, and Ctrl-V), some other codes that can only be entered using Ctrl-V might include: Ctrl-C (break), Ctrl-M (enter), Ctrl-P (toggle line printer echo) and Ctrl-S (pause display). Note that Toddy does not allow the NUL code (Ctrl-@) to be entered. The file name completion feature lets you quickly enter the name of an existing file. Just type the first few letters of the file name and press F9. The first file matching those letters will replace the letters. Pressing F9 again will replace the first matching file with the next matching file. If there are no more matching files, pressing F9 will do nothing. F10 works similarly to F9, except matching files are appended to previous matches (rather than replacing previous matches). The initial search pattern may include wildcard characters and may or may not in- clude a file name extension. Command History --------------- Every time you execute a DOS command, the command is copied to the command history for later retrieval. If there isn't enough room because of previously saved commands, Toddy will delete the oldest command or commands to make room. You can prevent a command from being saved to the command history by pressing Ctrl-Enter, instead of Enter, to run the command. You can copy a command to the command history without running it by pressing F5 or Ctrl-K. The up arrow key will retrieve the last command. Repeatedly pressing the up arrow key will retrieve progressively older commands. The down arrow key retrieves newer commands (the opposite of the up arrow key). Other keys for scrolling through the command history are listed in the Editing section above. Commands are not saved to the command history if they are identi- cal to the last command. Also, Toddy can be configured to pre- vent other types of commands from being saved. See the descrip- tions of the /HU, /HA, and /HM switches in the Switch Descrip- tions section. The command history may be written to a file or loaded from a file with the /HW and /HR switches. The current history can be locked, freed (unlocked), or cleared with the /HL, /HF, and /HC switches. When the history is locked, commands are no longer copied to it. The command history can be searched by matching the beginning characters. For instance, if you recently entered a long command like: tcc -v -ms zorro init.obj graflib.lib extra.lib you can search for this line by typing the first few characters, "tcc" for instance, and then pressing the Tab key. If there is more than one saved command that begins with "tcc", repeatedly pressing Tab will find each occurrence. If there are no more occurrences, the display will not change. Chained Commands ---------------- Multiple commands can be entered on a single line by using the "chain" character. The default chain character is Ctrl-T, but may be changed with the /CC switch. If the chain character was defined to be the caret (^), the command "arce files1^arce files2" will run the two consecutive commands "arce files1" and "arce files2". Any number of chained commands may be entered on a single line. Macros (described later) can also contain chained commands. To cancel sequence of executing chained commands, press Ctrl- Break. Pressing Ctrl-Break will usually interrupt chained com- mands even if you are inside an application. Macros ------ A macro is a user defined command that's automatically replaced by a single command or multiple commands chained together. Macros behave very much like small batch files. Some advantages of macros over batch files are that macros are executed faster (because they're stored in memory, not on disk), macros generally use less disk space (because multiple macros can be stored in a single file), macros can be defined or redefined on the fly, and macros can have any name (for example you could have a macro called DIR, but not a batch file). Some possible uses for macros are renaming commands (like defining D to execute a DIR) and applying default arguments to commands (for instance automatical- ly applying the /W switch to all DIR commands). Note that macros will NOT work in batch files. Macros are defined with the /MD and /ME switches and cleared with the /MU, /MF, and /MC switches. Macros can also be defined using the syntax: TODDY macro=text where "macro" is the name of the macro and all characters after the equal sign are what the macro should be replaced with. This second syntax for defining macros is equivalent to the /MD switch. You can also load and save macros to files with the /MR and /MW switches. Use the /ML switch to list the currently defined macros. Some simple macros might be: TODDY d=dir TODDY dir=dir /w TODDY /md'clear'del *.obj^del *.lst^del *.map' /cc94 The first example above makes D act like a DIR command. The next example automatically applies the /W switch to all DIR commands. The last example creates a CLEAR command to delete all OBJ, LST, and MAP files from the current directory. Note that the first two examples use one format for defining macros and the third example uses the other format. Macros can access command line arguments similarly to batch files. The first nine arguments are retrieved using the parame- ters $1 to $9 and the next 26 arguments can be retrieved using the parameters $A to $Z. The special parameter $* returns all arguments starting after the largest previously retrieved argu- ment. For instance, if you referred to $B in your macro, a $* will return all arguments starting with $C. The character indi- cating a parameter, a dollar sign by default, can be changed with the /CP switch. A more useful definition of the DIR macro above would use a parameter as follows: TODDY dir=dir $1 /w With this macro definition, a DIR without arguments would act like "DIR /W", and a "DIR *.COM" would act like "DIR *.COM /W". Another example: TODDY tcc=tcc -v $* userlib.lib This macro replaces TCC with one that automatically specifies multiple command line arguments. If you ran "tcc -O zipper", you'd actually be running "tcc -v -O zipper userlib.lib". Macro arguments are defined as sequences of characters separated by spaces, so there's no way retrieve an argument that contains spaces. This is might be a problem when defining a macro that runs a program like GREP (which could have a quoted string con- taining spaces). For instance, in the command: GREP "a string" *.doc parameter $1 is replaced by: "a parameter $2 is replaced by: string" parameter $3 is replaced by: *.doc The $* parameter is considered to be a single argument when referenced by a nested macro, even though it's replaced by multi- ple arguments. For instance, if you define: TODDY echo1=echo $3 TODDY echo2=echo1 A $* B ECHO2 will call ECHO1, which will echo the third argument of ECHO2; so running ECHO2 will always echo a B, no matter what arguments you use. Macros may be defined multiple times. The most recent definition always take precedence. A macro may also call another macro. If a macro calls a macro of the same name, the most recent defini- tion (prior to the calling macro) will be called. For instance, if the following macros were defined: TODDY dir=dir $* /w TODDY /cc94 dir=cls^dir $* a DIR command will call the second macro (because it's the most recent definition). This macro clears the screen (with CLS) and calls DIR. Since DIR has an earlier definition (the first macro), it's also called as a macro. The net effect of running a DIR command after defining these two macros is to clear the screen and perform a DOS DIR command with the /W switch. If a command is preceded by the "literal character", it is not interpreted as a macro. The literal character is undefined by default, but can be defined with the /CL switch. If the literal character is defined to be an exclamation mark, running "!DIR" will execute the standard DOS directory command regardless of any previous DIR macro definitions. You can run a command without any macro processing (or any other kind of processing) by pressing Ctrl-Enter instead of Enter. This feature is useful when defining macros from the DOS command line (rather than loading them from a separate file or defining them in a batch file). For instance, if you had defined the chain character to be the caret, you could not normally define the following macro from the DOS command line: TODDY d=cls^dir Because of the chain character, Toddy will interpret the above command as two separate commands: "TODDY d=cls" and "dir". However, if you run this command by pressing Ctrl-Enter (rather than Enter), Toddy will not interpret the caret as a chain char- acter. A similar restriction applies to the special DOS charac- ters: less than (<), greater than (>), and pipe (|). None of these characters can be used on the DOS command line or in a batch file as part of a macro definition, because DOS will inter- pret and absorb these characters. You can only use those charac- ters in a macro definition if you store the macro in a separate file and load the file with the /MR switch. Toddy beeps and cancels the currently running macro if: 1. there's an error processing a macro parameter; 2. the macros are nested too deeply; or 3. the macro expansion is too long. Note that macro parameters are processed similarly to nested macros and count towards the maximum macro nest level. If you get a beep, you could try increasing the maximum nest level with the /MN switch before looking for errors in your macro definitions. Another potential problem is circular macro references. For instance: TODDY a=b TODDY b=c TODDY c=a You will always get an error if you try to run one of the three macros defined above, because these macros continuously call each other until the macro nest level is exceeded. Switches -------- Switches take affect when Toddy is installed or can be passed to an already resident Toddy by running Toddy again. Switches may be written to the executable file TODDY.COM with the /W switch. When switches are written to the executable file, they automati- cally take effect when Toddy is installed. A list of the Toddy command line switches are displayed to the screen by running: TODDY /? In the switch descriptions of the following sections, a "d" de- notes a decimal digit, an "x" denotes a hexadecimal digit, and an "'s'" denotes a string in quotes. The number of decimal or hexadecimal digits only serve as a general reference to the magnitude of the number -- in most cases fewer digits are al- lowed. Switch Summary -------------- Installation: /Q quiet mode /V verbose mode /E enable Toddy /D disable Toddy /W write switches /U uninstall Toddy Attributes (colors): /ATxx text attribute /ACxx cursor attribute /AExx end attribute Cursor Type: /TC use custom cursor /TS use system cursor /TExxxx entry cursor type /TIxxxx insert cursor type /TOxxxx overwrite cursor type /TXxxxx exit cursor type Characters: /CLddd literal character /CPddd parameter character /CCddd chain character Insert Mode: /II select insert mode /IO select overwrite mode /IR reset insert /IP preserve insert History: /HSddddd command history size /HMddd minimum command length /HU save unique commands /HA save all commands /HL lock history /HF free history /HRfile read history from file /HWfile write history to file /HC clear history Macros: /MSddddd macro table size /MNddd maximum macro nest /MD's's' define macro /ME's's' exchange (replace) macro /MU's' undefine macro /MF's' forget macro /MC clear all macros /ML list macros /MR read macros from file /MW write macros to file Miscellaneous: /A display memory allocations /BSddd set input buffer size /FTxx file name completion types /Mddd multiplex number /UI uppercase ignored /US uppercase significant Switch Descriptions ------------------- /A Display memory allocations. The first three numbers displayed are: the memory allocated for the command history, macro table, and file name completion. The last three numbers are: the total allocated memory (usually the sum of the first three numbers), the memory used by macro definitions, and the amount of available memory. All available memory can be used for macros. Whatever memory isn't used by macros is used for the command history (or the file name completion commands if needed). See the Notes section for more information on memory usage. /ACxx Set the attribute of the character under the cursor. The first digit of the attribute byte is the background color and the second digit is the foreground color. Color values of 0 to 7 correspond to black, blue, green cyan, red, magenta, brown, and white. Adding 8 to the lower nibble makes the foreground color brighter. Adding 8 to the upper nibble makes the foreground blink. The default is /AC7 (white on black). /AExx Set the attribute of the blanks following the text. The /AC switch describes attribute bytes. The default is /AE7. /ATxx Set the attribute of the text. The /AC switch de- scribes attribute bytes. The default is /AT7. /BSddd Set the input buffer size. If this switch is used, Toddy will only process input when the specified number of characters are requested. To restrict Toddy to DOS commands, use /BS128 for COMMAND.COM and /BS255 for 4DOS and NDOS. /CCddd Define the chain character. The chain character is used to specify multiple commands on single line or in a macro. The number is the ASCII value of the charac- ter. The chain character cannot be a space. The default is /CC20 (Ctrl-T). Chain characters are de- scribed in the Chained Commands section. /CLddd Define the literal character. A literal character forces Toddy to pass a command directly to DOS without interpreting it as a macro. The number is the ASCII value of the character. The literal character cannot be a space. The default is /CL0 (no literal character defined). Literal characters are described in the Macros section. /CPddd Define the parameter character. This is the character used to specify parameters within macros. The number is the ASCII value of the character. The parameter character cannot be a space. The default is /CP36 (a dollar sign). Macro parameters are described in the Macros section. /D Disable the resident Toddy. All command input will be performed by DOS as if Toddy wasn't installed. /E Enable the resident Toddy. This switch undoes the effect of the disable switch, /D. /FTxx Select the file types for file name completion. This switch allows you to specify what types of files will be matched by the file name completion commands (F9 and F10). The possible values are: 00 = normal file, 02 = hidden files, 04 = system files, and 10 = directories. Add the hexadecimal values together to combine types. /FT10 (00 + 10) finds all normal files and directories. /FT06 (00 + 02 + 04) finds all normal, hidden, and system files. /FT16 (00 + 02 + 04 + 10) finds all files and directories. The default is /FT00 (find normal files only). /HA Save all commands to the command history. This switch undoes the effects of the /HU switch. This is the default. /HC Clear command history. All saved commands are deleted. If you want to save a sequence of DOS commands as a batch file (with the /HW switch), you could use this switch to first clear any previously saved commands. You can also clear the command history by pressing Alt-F7. /HF Free the command history. Commands will be saved to the command history normally. This switch undoes the effects of the /HL switch. /HL Lock the command history. This switch prevents further commands from being saved to the command history. Unlock the history with the /HF switch. /HMddd Set the minimum command length. All commands that are shorter than this value are not saved to the command history. This switch is useful if you don't want to save trivial commands like DIR or CLS. The default is /HM0 (all commands are saved). /HRfile Read the command history from a file. Each line of the specified file is added to the command history. If the command history is not large enough, older lines are deleted to make room. The normal criteria for saving commands (like minimum length) are not used. The file may be created from scratch or be a previously saved history. The file must a standard text file. /HSddddd Set the command history size. The command history size is the number of bytes reserved for saving commands. If you don't use the command history, you can conserve memory by setting the size to 0 with /HS0. The default is /HS256. /HU Save unique commands only. Toddy will scan the command history and only save a command if it's different than all the other saved commands. This switch is useful if you primarily retrieve past commands by searching rather than scrolling up or down the history. This switch has the opposite effect of the /HA switch. /HWfile Write the command history to a file. All commands stored in the command history are written to the speci- fied file. The commands are saved as a standard text file. This switch can be used to run a sequence of DOS commands and then save them as a batch file. /II Select insert mode for editing. This is the default mode. /IO Select overwrite mode for editing. /IP Preserve the insert/overwrite mode between commands. The insert or overwrite mode is preserved from the last time a command was entered. This switch has the oppo- site effect of the /IR switch. /IR Reset the insert/overwrite mode between commands. Each time a command is entered, the mode will be set to insert or overwrite (depending on the current mode when this switch is used). This switch has the opposite effect of the /IP switch. This is the default. /Mddd Set the multiplex number. If you get the message "Multiplex number in use by another program" when you try to install Toddy, you can change the multiplex number with the /M switch. The multiplex number should be in the range 192 to 255. The default is /M215. /MC Clear all macro definitions. This switch can be used to delete all currently defined macros, or to ignore any macros saved to TODDY.COM during installation. /MD's's' Define a macro. This parameter uses two fields, the macro name and the replacement text. The first charac- ter after the /MD is the definition delimiter. Though this delimiter is usually a quote (or double quote), it can be any character not used in the macro or replace- ment text. There are three delimiters: one at the start of the macro name, one separating the macro name from the replacement text, and one at the end of the replacement text. The macro name can be any sequence of characters as long as it doesn't contain any spaces. The replacement text can contain any sequence of char- acters. Note: this switch does not remove any previous definitions of the macro. Use the /ME switch to re- place the most recent definition of a macro. Macros are described in the Macros section. /ME's's' Exchange a macro. This switch replaces the most recent definition of a macro, which is equivalent to undefin- ing then defining a macro. The syntax and usage are identical to the /MD switch. /MF's' Forget a macro. This switch clears all definitions of a macro (not just the most recent definition). The macro name is delimited similarly to the macro defini- tion switch (/MD), except there is no replacement text. Use the /MU switch to clear only the most recent defi- nition. /ML List macros. All currently defined macros will be displayed. /MNddd Set maximum macro nest level. A nest level is used when a macro calls another macro OR when a macro ac- cesses a parameter. If the maximum nest level is reached while running a macro, Toddy will beep and abort the macro. Toddy requires 8 bytes of memory for each nest level. If you don't use macros, you can conserve memory by setting the nest level to 0 with /MN0. The default is /MN10. /MRfile Read macros from a file. The file must be a standard text file. The file may be created by the user or by saving macros with the /MW switch. Each line of the file contains a single macro definition. The macros must be defined in the form: macro=text where "macro" is the name of the macro and "text" is the replacement text for the macro. All characters after the first equals sign become part of the macro text. /MSddddd Set the macro table size. The macro table size is the number of bytes reserved for macro definitions. If you don't use macros, you can conserve memory by setting the table size to 0 with /MS0. The default is /MS256. /MU's' Undefine a macro. This switch clears the most recent definition of a macro. The macro name is delimited similarly to the macro definition switch (/MD), except there is no replacement text. Note that a macro may have multiple definitions and this switch only clears the newest. Use the /MF switch to clear all defini- tions of a macro. /MWfile Write macros to a file. All currently defined macros are written to the specified file. The file is a standard text file with one macro definition per line. Macros saved with this switch can be loaded with the /MR switch. /Q Enable quiet mode. When Toddy is in quiet mode, the regular confirmation messages are suppressed -- only error messages are displayed. If quiet mode is saved (i.e. "TODDY /Q /W"), Toddy's banner will also be suppressed. /TC Use the custom cursor type defined with the /TE, /TI, and /TO switches. The /TE, /TI, and /TO switches auto matically set this switch. /TExxxx Set the entry cursor type. This switch sets both the insert and overwrite cursor types. This switch should be used instead of, but not with, the /TI and /TO switches. The cursor type is the size and shape of the blinking cursor blob. The first byte of this two byte value is the top scan line number and the second byte is the bottom scan line number. The scan lines for CGA are numbered 00 to 07, for EGA adapters it's 00 to 0D, and for VGA adapters it's 00 to 0E. The default cursor is usually the bottom two scan lines (i.e. 0607 for CGA, 0C0D for EGA, and 0D0E for VGA). You can make a big blinking blob on most adapters with 000F. You can turn off the blinking cursor entirely on most adapters with value of 2000. /TIxxxx Set the insert cursor type. This is the cursor type used when in insert mode. The /TE switch describes how to set the cursor type. /TOxxxx Set the overwrite cursor type. This is the cursor type used when in overwrite mode. The /TE switch describes how to set the cursor type. /TS Use system cursor (i.e. don't make any changes to it). This switch turns off all the custom cursor settings. This is the default. /TXxxxx Set exit cursor type. This is the cursor type to use when Toddy has finished inputting a line. Generally, this switch is used to restore the cursor after setting it with the other cursor switches. For this and the other cursor switches, if no cursor is specified, the current system cursor will be used (i.e. this switch usually isn't necessary). /U Uninstall Toddy. This switch removes Toddy from memo- ry. It may not be possible to uninstall Toddy if another TSR has been loaded after Toddy. /UI Uppercase letters are ignored. This switch undoes the effects of the /UI switch and is the default state. /US Uppercase letters are significant. If this switch is specified, Toddy will treat uppercase and lowercase letters as being different. For instance, if you define a macro called "DIR" and ran the command "dir", the macro will NOT be run. This switch also affects command history operations, like searches and saving unique commands (the /HU switch). Note that DOS is NOT case-sensitive -- this switch only affects Toddy. /V Enable verbose mode. This switch undoes the effects of the /Q switch. /W Write current settings to TODDY.COM. All switches and macros will be written the executable file TODDY.COM. The settings will be the new defaults the next time Toddy is installed. A macro definition may be removed from TODDY.COM by undefining the macro and rewriting the settings. If you are running DOS 2.X, TODDY.COM must be in the current directory when using this switch. Examples -------- TODDY Install Toddy using the default switches. TODDY /hs10000 /ms100 /to000f Install Toddy with a 10000 byte command history, 100 byte macro area, and set the cursor scan lines to a big blinking blob whenever overwrite mode is in effect. TODDY /at1F /ac4F /ae1F /te2000 Set the colors to a uniform bright white on blue with a red block cursor. The blinking cursor is turned off for each input. TODDY /hs1000 /hm6 /w Write the /HS1000 and /HM6 switches to TODDY.COM so they don't need to be specified the next time Toddy is installed. TODDY /md'dir'dir $* /w' /md'del'move $1 c:\trashcan' /cl33 Define two macros and set the literal character to an exclama- tion mark. The first macro appends the /W parameter to all DIR commands. The second macro makes the DEL command move files to be deleted to a directory called TRASHCAN, where they can be later retrieved if you change your mind about the deletion. With the definition of the literal character, !DEL performs a regular and permanent delete. The DEL macro requires a MOVE utility, which isn't usually included with DOS, but is avail- able on many BBS's and online services. TODDY /u Remove Toddy from memory. Version Changes --------------- Version 2.00 First public release. Version 2.01 Several command line switches renamed. Version 2.10 Ctrl-Break implemented and mouse support removed to conserve memory. Version 2.11 Search command made case-insensitive. Version 2.20 Cursor switches expanded. Version 3.00 Complete rewrite. New features include chained commands and macros. Other changes include: most command line switches renamed, switches are automatically passed to a resident Toddy (no /RS needed), default values changed, several editing keys changed, delimiters for move word left and right changed, and history search improved. Version 4.00 Many new features added: macros and the command history may be saved and loaded from a file, control characters can be en- tered, Ctrl-Break cancels chained commands and macros, DOS editing keys supported, file name completion, and more. Other changes include: several editing keys changed, alternate syntax for defining macros, switches must start with a slash (/), macro parameter syntax slightly changed. Notes ----- Toddy performs the same function as the DOSKEY utility provided with DOS version 5. The two programs are somewhat macro and keystroke compatible, but the command line switches are totally different. By and large, Toddy has a more features than DOSKEY but uses less memory. One significant feature of DOSKEY that's absent from Toddy is the command to display the contents of the command history and select a past command by line number. Toddy will work with 4DOS (and the version of 4DOS licensed to Peter Norton Computing called NDOS) if the /L1 parameter is set with the SETDOS command. When Toddy is installed under 4DOS, many of 4DOS' features are still available, including aliases and multiple commands. Toddy is somewhat redundant when using 4DOS, since most of the features of Toddy are available through 4DOS. Note that if you use /BS switch, the setting for 4DOS must be /BS255. You may have some trouble using redirected input with programs like DEBUG and EDLIN when Toddy is installed. If Toddy receives a redirected text file, Toddy will interpret both the carriage return and linefeed, which are at the end of every text line, as the ENTER key. If effect, you'll get two ENTER's after every line. To fix this problem, temporarily disable Toddy or use the /BS switch. Redirected input is frequently used to assemble small programs using the DEBUG program. The memory allocated with the /HS and /MS switches is assigned to a common pool. If you allocate memory to the command history but no memory to the macro table, you will still be able to define macros, though this will leave you with less than the allocated amount of history space. The /A switch displays the current memory allocations. All available memory may be used for macros, and whatever memory is left over is used for the command history. The third number displayed by the /A switch is the memory re- quired by the file name completion commands (F9 and F10). There must be at least that many bytes free to use these commands. When the file name completion commands are used, the size of command history may adjusted downward by deleting the oldest entries. The DOS template commands (F1 to F4) use the most recent command line stored in the command history, so if you plan on using these keys, you should make sure that there is enough history space (i.e. enough free space) to hold at least one command line. Before Toddy is installed, all available memory is allocated to the memory pool. If you run "TODDY /A" before installing Toddy, the total allocated memory will usually be larger than the sum of the first three numbers. Each command of a chained command is displayed as it is executed. Only the final form of the command is displayed (that is, after all macros have been processed). To see the see final form of the first command, precede the chained commands with the chain character. For instance, if you defined the following macro: TODDY d=dir when you run the "d" macro, you will not see the DIR command, just the results of the DIR. If you wish to see the actual DIR, assuming the chain character is a caret, define the macro as: TODDY d=^dir If you have saved macros to TODDY.COM (using the /W switch), use the /MC switch to install Toddy without those macro definitions. It may be necessary use the /MC switch to install Toddy with a macro and history size of zero if you have saved macros in this manner. ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of Public (software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. PsL cannot debug pro- programs over the telephone, though we can answer questions. Disks in the PsL are updated monthly, so if you did not get this disk directly from the PsL, you should be aware that the files in this set may no longer be the current versions. Also, if you got this disk from another vendor and are having prob- lems, be aware that some files may have become corrupted or lost by that vendor. Get a current, working disk from PsL. For a copy of the latest monthly software library newsletter and a list of the 3,000+ disks in the library, call or write Public (software) Library P.O.Box 35705 - F Houston, TX 77235-5705 Orders only: 1-800-2424-PSL MC/Visa/AmEx/Discover Outside of U.S. or in Texas or for general information, Call 1-713-524-6394 PsL also has an outstanding catalog for the Macintosh.