FUNKEYS.INIT   v0.4

Funkeys is an 'INIT' (ProDOS 16 STaRtup) program that adds several new keyboard
commands to your system.  This program should be copied to your SYSTEM.SETUP
directory so that it may install itself while ProDOS 16 is booting.

This is version 0.4 of FUNKEYS.  There have been three changes made since
version 0.2, which are documented at the end of this file for older users.

FUNKEYS gives you many special 'command' keys that provide functions similar
to those already available to Mac and PC users.  This includes a print-screen
key, a key that saves a super-hires screen to disk, disk eject keys for your
3.5 drive (just like the MAC), a system shutdown key, and many other useful
things.  In future versions I hope to include full blown keyboard macros as
well.  

Once FUNKEYS is installed, the system hearbeat interrupt will be turned on, and
FUNKEYS will be able to observe the keyboard latch for it's new command keys.
FUNKEYS depends on the heartbeat interrupt to operate, and any program that
disables it, or the VBL interrupt directly through the MISC tools will cause
FUNKEYS to cease operations.

FUNKEYS will operate in both the 8 and 16 bit environment, although some
options at this time require you to be in ProDOS 16 to function.  FUNKEYS
should not interfere with the operation of any program you run, and, if it
does, I would be interested in hearing the nature of the problem you are
having.  If FUNKEYS is turned off for any reason, it may be restarted by
pressing <CONTROL> <RESET) or by rebooting ProDOS 16.

All your new 'command' keys are activiated by first simultaneously pressing
down the <CONTROL> and <OPTION> keys, and WHILE HOLDING THESE KEYS DOWN,
pressing the desired command key you wish to use.  Incidently, any running
program will pause if you simply hold down the <CONTROL> and <OPTION> keys
until you release them.

You will also notice that several functions may be activated by the use of one
of several commands.  This redundency is used in case the original key is
replaced by a keyboard macro.  FUNKEYS macros, when implimented, will not be
able to be keyed to the numeric keypad, and all of the current functions are
tied to some keypad key. 


<CTRL> <OPT> ?          This brings up the new FUNKEYS 'quick help' screen.

<CTRL> <OPT> 1-4        Pressing function keys 1-4 will attempt to eject disks
                        connected to your smartport in slot 5.  This is similar
                        to pressing command-shift 1-4 on a Mac.  Since the
                        Apple smartport firmware does not order external drives
                        sequentially (if you have a ramdisk active, your second
                        3.5 drive gets mapped as drive '3', for example), you
                        will normally need to use the '3' key to eject the
                        second drive.

<CTRL> <OPT> B          Either of these keystrokes will blank your //gs
<CTRL> <OPT> 5          display screen until another key (any key) is pressed.
<CTRL> <OPT> <CLEAR>    Your screen display will then be restored to it's
                        original state.  This may be used if you wish to
                        leave the computer for awhile, but don't wish to turn
                        it off.

<CTRL> <OPT> <DELETE>   This function will blank your screen display, eject all
<CTRL> <OPT> 6          your 3.5 drives and remain in this state until you
                        press <CONTROL> <RESET> to reboot your machine.

<CTRL> <OPT> <P>        This is the print-screen function key.  A copy of your
<CTRL> <OPT> <0>        80 or 40 column screen will be sent to your printer.
                        Print-screen only works with printers in slot #1, and
                        may not be compatible with some printer cards.  Also,
                        funkeys now sends mousetext characters to an IW2
                        printer.

<CTRL> <OPT> <=>        If your printer does not support mousetext and other
                        Imagewiter II features that may be used in future
                        versions of FUNKEYS (did I say color graphic dump?),
                        this key will disable those features until the next
                        time you boot.  FUNKEYS will acknowledge with a BEEP
                        when this is pressed. 

<CTRL> <OPT> <RETURN>   This function sends a form feed to your printer so it
                        will skip to the next page.

<CTRL> <OPT> <SPACE>    This function sends a c/r to your printer so that it
                        will skip to the next line.

<CTRL> <OPT> <S>        This function will capture your super-hires display as
<CTRL> <OPT> <9>        an unpacked 32K super-hires image file.  You can use
                        this to capture images of running p16 applications. 
                        These screen images are saved on your current directory
                        (prefix 0/) as files named SCREEN001...SCREENnnn.  The
                        filename is incremented each time you use this function
                        key and is not reset back to 001 until you reboot.  If
                        you are not currently in ProDOS 16, or, if ProDOS 16 is
                        currently busy handling another call, the system will
                        beep at you instead.   


                        SUPPORT PROGRAMS

Several support programs have been added with FUNKEYS v0.2.  These are intended
to be used with program selectors to disable FUNKEYS before running programs
that are incompatible and to re-enable FUNKEYS afterwards.

FKEYS.OFF               A simple system program to disable FUNKEYS operation.

FKEYS.ON                A simple system program to re-enable FUNKEYS operation.

SETKEYS [ON or OFF]     A COMMAND.COM program to turn FUNKEYS on or off.


                        REVISION HISTORY

Ver 0.1         releaaed early June, 1988       - original version

Ver 0.2         released mid june, 1988

The text screen printer dump now supports both 40 and 80 column text screens
as well as mousetext on Imagewriter II printers.  If you have a non-IW2 printer
you will need to press the new <CTRL> <OPT> <=> command to disable mousetext.

SYSBEEP is no longer used for beep sounds from FUNKEYS.  Instead, a special
beep routine is included inside FUNKEYS.  Some kinds of SYSBEEP inits could
not be accessed from inside FUNKEYS properly.

The disk eject now supports UniDISK 3.5 drives along with the Apple 3.5.

A FUNKEYS pop-up quick help guide has been added (use <CTRL> <OPT> ?) along
with a 'linefeed' command for your printer.

Finally, several additional 'support' utilities have been added for FUNKEYS.

Ver 0.3         released July 22, 1988

The FUNKEYS help screen now works properly in 40 columns mode with the standard
Apple character set enabled.

FUNKEYS will now ignore any <CTRL> <OPT> command key if the <SHIFT> key is
also pressed at the same time.  This allows you to enter <CTRL> <CLOSED-APPLE>
commands to those programs that may require them.

FUNKEYS is currently distributed as a shareware utility (fee of $10.00 if you
find this utility useful and wish to contribute).  However, it may not be
commercially distributed alone or as part of another package without my
permission.  It may be uploaded to any public access commercial information
service (SOURCE, GEnie, CI$, etc) as well as BBS systems.

Ver 0.4         released July 27, 1988

It seems an 'improvement' in system disk 3.2 has been causing minor problems
with Funkeys.  This involves the misc toolset, which was being restored to
the toolset table established by the p16 patch code instead of using the new
one established by FUNKEYS.  Funkeys now patches the original table (if in
ram) as well as it's own private copy.  This patch was needed so that
FUNKEYS could re-connect itself after a reset and so that utilities like
FKEYS.ON and OFF could locate FUNKEYS in memory, which was not happening with
system disk 3.2.


David Sugar                             SOURCE: SIG054
Hyperdyne Software                      GEnie:  D.SUGAR1
PO Box 641156                           Usenet: ..gryphon!igloo!lazarus
Chicago, Il 60664-1156                          ..ihnp4!ddsw1!igloo!lazarus
