           Batch files utility collection v1.00 beta (March 1996)
                 Programs and manual by Javier Thaine

IMPORTANT: These programs might not work with early versions of DOS.
           Beta means bugs. That means that these programs might have
           bugs. I have tested them and they appear to be fine, but
           use them at your own risk. I am not responsible for any
           damage caused by them.

        This is a kit of very small utilities (possibly ranging from 4 bytes
to 20000 bytes) for use in batch files. They are easy to use. Here is
what they do:

NOTE: The result of an operation is passed through the batch file
      variable ERRORLEVEL. Read your MS-DOS manual to find out more
      about it.

The letter beside the name specifies the language it was coded in.
They are C, C++ and Assembly (A).

Program      Coded in:  Use
^^^^^^^      ^^^^^^^^^  ^^^
KEY.COM            A    Lets the user press a key. The ASCII code
                        of the key he pressed is returned in ERRORLEVEL.
KEYUPR.COM         A    Same as KEY.COM, except that lowercase letters
                        are turned into uppercase.
KEYLWR.COM         A    Same as KEY.COM, except that uppercase letters
                        are turned into lowercase.
TEXTMODE.COM       A    Don't you hate it when you're stuck in graphics
                        mode inside DOS? Well, whenever this happens to
                        you, just use the TEXTMODE command to return you
                        to text mode (80x25). This is also useful when
                        you are stuck in an undesired text mode, such
                        as 40x25 (doesn't everybody hate that mode?)
DETVGA.COM         A    This will detect if the user has a VGA graphics
                        compatible card. If he does, ERRORLEVEL is 0.
                        If he doesn't, ERRORLEVEL is 1.
BEEP.COM           A    Generates a PC-Speaker BEEP with ASCII
                        character 7.
DELAY.COM          C    Waits a specified number of milliseconds.
                        Syntax is DELAY milliseconds. Maximum: 65535
                        (65 and a half seconds).
SOUND.COM          C    Turns on PC Speaker at requested frequency in
                        Hertz (Vibrations per second). Syntax is
                        SOUND frequency. Maximum: 65535 Hz.
                        Humans can hear from around 20 to 20000 Hz.
NOSOUND.COM        C    Turns off PC Speaker.
YESNO.COM          A    Useful for a Yes/No question. Waits until either
                        the Y key or N key is pressed. ERRORLEVEL is 0 if
                        N was pressed. ERRORLEVEL is 1 if Y was pressed.

        All these commands are demonstrated in the batch file DEMO.BAT.
Read it to learn about these commands and about batch files in general.
The programs that were coded entirely in assembly language are very
small (4-1000 bytes). Those written in C and C++ are bigger. I will try
to make all of these programs in assembly in the future, both for the
sake of speed and size. I am working to make these programs as small
as possible.

        Please send me your comments and suggestions.

Future plans: Create more useful commands, such as data entry and file
              manipulation from batch files.
