                              K-TOOLS UTILITIES


               Copyright (c) 1994 by Rob McDonell, ARK ANGLES
                             All Rights Reserved


                             KEYIN - Key In 1.1


This utility enters keystrokes into the keyboard buffer, especially
useful for automating responses in batch files.  This works in the same
way as the .KEYIN macro command in K-Tools Desk Caddy and Workplace.


USEAGE:

  KEYIN [parm [parm [..]]]

where:  parm       is a string of normal and/or special characters

Normal characters, that is a-z, A-Z, 0-9 and most other symbols are put
directly into the keyboard buffer as is, thereby covering almost all of the
common "typewriter" keys.

Special characters are those that cannot be entered as normal characters,
such as function keys, cursor movement keys and control codes.

Note that any spaces in the KEYIN parameter will be ignored.  If you want
to enter a space character into the keyboard buffer, use the special
character underline.

Note also that the keyboard buffer can usually only hold about 15 keystrokes
at one time.  Any additional characters entered will be ignored.


SPECIAL CHARACTERS:

 ~     (Tilde) will generate the <Enter> key.

 _     (Underline) will generate the <Space> key.

 /     (Slash) will generate the menu <F10> key.

 /n    (Slash followed by a single digit) will generate a function key:

       /1  <F1>
       /2  <F2>
       /3  <F3>
       /4  <F4>
       /5  <F5>
       /6  <F6>
       /7  <F7>
       /8  <F8>
       /9  <F9>
       /0  <F10>

 @z    (At sign followed by a single character or digit) will generate <Alt>
       plus that character or digit.  The character may be in upper or lower
       case.

 ^x    (Hat followed by a single character) will generate <Ctrl> plus that
       character.  The character may be in upper or lower case.

 \nnn  (Backslash followed by a three digit number) will generate a character
       with ASCII code nnn.  This allows any character, including those
       otherwise unprintable or inaccessible by the keyboard, to be entered.

 \x    (Backslash followed by a single character) will generate one of the
       cursor movement keys.  The character may be in upper or lower case:

       \C  <Esc>          (escape)
       \T  <Tab>          (forward tab)
       \S  <Shift+Tab>    (reverse tab)
       \B  <Bksp>         (backspace)
       \I  <Ins>          (insert)
       \D  <Del>          (delete)
       \H  <Home>
       \E  <End>
       \P  <PgUp>         (page up)
       \N  <PgDn>         (page down)
       \L  <Left>         (cursor left)
       \R  <Right>        (cursor right)
       \U  <Up>           (cursor up)
       \W  <Down>         (cursor down)

       Any other character following a backslash is treated literally.  For
       example, "\Q" is just the same as "Q".  This allows the other special
       characters above to be used normally:

       \~  literal tilde
       \_  literal underline
       \/  literal slash
       \@  literal at sign
       \^  literal hat
       \\  literal backslash

All other alphabetic, numeric, and punctuation characters are used
exactly as they are.


EXAMPLES:

  KEYIN deskcad~^omyfile~        will run Desk Caddy and open MYFILE on the
                                 screen.  Note the use of the tilde for
                                 <Enter> and the hat for a control key.

  KEYIN wipe_*.bak~y~            will run WIPE to obliterate all the *.BAK
                                 files in the current directory and
                                 automatically enter the 'y' response.  Note
                                 the use of the underline for a space.

  KEYIN rmtree_a:\\~y~           will run RMTREE to remove the contents of
                                 the root directory of drive A: and
                                 automatically enter the 'y' response.  Note
                                 the use of the two backslashes in a row to
                                 get a single backslash.

Run KEYIN with no parameters or "?" or "/?" to display simple help and
registration information.


REGISTRATION:

This program is part of the K-TOOLS UTILITIES shareware package.  To keep
using it after the 60 day trial period you must register, which costs only
A$10 per utility or A$29, US$22, 15, Dm40, 2400 for the whole collection.

Author:     Rob McDonell
            ARK ANGLES
            P O Box 190 (61 Oaklands Rd)
            Hazelbrook  NSW  2779
            AUSTRALIA
Phone:      Intl+61-47-588100
Fax:        Intl+61-47-588638
Compuserve: 100237,141
Internet:   100237.141@compuserve.com
