OS/2 Shareware BBS: SysTools/SysTools.zip/hook4301.zip/readme.1st

Text File | 1996-02-07 | 9KB | 201 lines

Information for HOOK  vs 4.30                        Tue  02-06-96

------------------------------- INSTALLATION -------------------------------

From the directory containing the UNZIPPED files as the current directory

    type   INSTALL

and follow the directions and prompts from the Install Program.

!! DO NOT install this into the same directory as any current version    !!
!! of HOOK. If you wish to retain the same name for the directory in     !!
!! which to Install, then move the current content to another directory. !!
!! or rename the directory containing the earlier the current version.   !!

!!! AFTER HOOK is installed DO NOT rename the  directory or any of the  !!!
!!! files relating to HOOK. When HOOK is installed it copies the name   !!!
!!! of the directory into which it is installed into HOOK.EXE and that  !!!
!!!           information is required when HOOK is loaded,              !!!

I believe this version has all the problems with switching to loaded
Hot Key programs fixed as well as the maintenance of the files
HOOK.INI and HOOK.HKY. It has modified the way PM type programs
are handled and includes new HOOK window messages and display behavior.
When a Program is FIRST loaded by HOOK, the HOOK window will FLASH and
display the Message HOOK BUSY until the critical part of the program load
has occured. When the HOOK window stops flashing then it is safe to active
another HotKey.  The time for a Program to Load is highly dependent on
the particular program and happen almost instantaneously or take seconds
to complete.

There are some very few programs that do not install into the Task List.
Since HOOK uses the Task List for its information on Program Loading and
Unloading these cause a problem. That is handled by the use of a Timer.
When any HOOK program is loaded, a Timer is started that turns off the
Flashing Window and resets some other crucial parameters of HOOK so that
it will continue to function normally. This time delay is set at 10
seconds.

I have included a section in HOOK.INF (HOOK.TXT) on how HOOK works.

This is a significantly Updated Version and you should read the documentation
before Installing or Using It.

FOUR new significant Capabilitoes have been added to HOOK.

PASS  STARTUP HOT KEY to HOOK to Call After Loaded
       When Hook is loaded a HotKey to Execute by HOOK can be passed
       to HOOK on the Command Line to Execute after HOOK is loaded.

PASTE TEXT STRINGS INTO Windows
       Text Strings may be assigned to HotKeys and when that HotKey
       is struck the assigned text is pasted into the window with the
       Keyboard Focus.
,
EXECUTE SEQUENCES OF HOT Keys
       This is a macro like capability that does not require recording.
       A sequence of HotKeys may be assigned to a single HotKey and all
       will be executed when that HotKey is struck.

SCHEDULE Hot Keys Option
       This is a completely new addition which allows the user to
       Schedule any assigned Hot Key for execution at a specified
       time (hh:mm AM or PM) on any, all or selected days of the
       week. At the  specified time the  program is executed just
       as if the Hot Key key strokes had been entered at the Keyboard.

   IN ADDITION PLEASE NOTE THE FOLLOWING CHANGES FROM EARLIER VERSIONS

MACRO RECORDING now omits WM_MOUSEMOVE messages.
         This speeds up playback and loses nothing since those messages
         just display the mouse pointer moving from one location to
         another. The actions at the end of that are unchanged.

MACRO PLAYBACK started by Shift-Ctrl-Ins within HOOK may be terminated
         by pressing the Esc Key.

PLAYKEYS.EXE IS NO LONGER INCLUDED.
         The format of this program is not compatible with the new
         installation of HOOK BUT more importantly, its task has been
         superseded by the PASTE TEXT STRINGS INTO Windows option.

HOOKQDLL.DLL HAS BEEN CHANGED.
         The change is required to accomodate a new configuration parameter.
         See below for those additions.

HOOK.INI HAS BEEN CHANGED.
         In order to save the additional configuration parameters HOOK.INI
         has increased in size. In addition some reserve bytes have been
         added for potential future use.

HOOK DISPLAY WINDOW
         Now displays messages when HOOK is loading/switching programs.
         Message indicates that a program is being loaded or if
         switching the technique used for Switching .i.e.SwitchList Handle.
         (the Task List title is no longer used by HOOK).

USER ASSIGNABLE HOT-KEYS ADDED
         Two new user assignable Hot Keys have been added. This results
         in HOOK.HKY increasing in size by 2*278 bytes. They are 2-Char
         Hot-Keys  Alt-Pause and Shift-Pause. In HOOK.DAT they may
         entered as Pse-A and Pse-S for assignment.

DEFINE HOT KEYS ENTRY SCREEN
         This has been significantly changed to display current
         assignments of a Hot Key for Editing.

HOOK.HKY BINARY FILE STORING HOY-KEY INFORMATION.
         Automatically read in when HOOK loaded and saved when HOOK
         unloaded. If you want to read this, use a HEX editor.

         BE sure and use the new one and use HOOK.DAT to read old
         settings back in.

HOT-KEY TASK MODIFIED:Shift-Alt-UpArrow
        Shift-Alt-UpArrow no longer reads in HOOK.DAT. It now reads in
        HOOK.HKY from disk.

NEW BUILT IN HOT-KEY:Shift-Ctl-UpArrow
        HOOK.DAT is now read in by Shift-Ctl-UpArrow. In addition
        HOOK.DAT is NOT automatically read in when HOOK is loaded but
        may be read in as indicated above. Any assignments in HOOK.DAT
        will overwrite those currently in effect.

NEW BUILT IN  HOT-KEY:Alt-Ctrl-Esc
        In this version of HOOK, when HOOK is loaded the 3-Key sequence
        Ctrl-Alt-Del that is used for rebooting is disabled (by using a
        DosDevIOCtl Command). In its place this Hot-Key will display a
        message asking "Do You Really want to REBOOT ?" and informing
        you that if the answer is Yes, it will re-enable Ctl-Alt-Del
        BUT that no HOOK files will be saved. I have included this option
        because the Built in Hot-Keys Shift-Alt-End and Shift-Alt-Del
        may sometimes be inadvertenlty hit as Ctrl-Alt-Del ( I have one it
        on some occasions) and this then will not allow that to happen
        and any attempt to reboot will give you a warning message.

        NB. DISABLING Ctl-Alt-Del also DISABLES Alt-Home which in a DOS
        window allow switching between a DOS window and DOS Full Screen.

NEW CONFIGURATION OPTIONS in Shift-Alt-F2 ACTIVATED MENU.

        Message Display KeyPad Use Options
          An additional option to toggle OFF/ON the BEEP when HOOK
          is loaded.

        New Menu Option for DLL
          Toggle OFF/ON how HOOKQDLL treats WM_CHAR messages. Currently
          WM_CHAR messages indicating a Hot-Key entered from KeyBoard
          are NOT PASSED on to System Message Queue. This option allows
          that behavior to be changed.

        Display Scheduled Hot Keys
          This lists on the screen the Hot Keys that are currently
          scheduled and the specifics of the Schedule for that Hot Key.
          (see above for that new option)

This version is backward compatible with earlier versions except as
noted above with respect to the files HOOKQDLL.DLL, HOOK.INI  and
HOOK.HKY .

The INSTALL program has been modified to copy the readme.1st file to
the target directory as well as the two DLL files. The DLL files are
now no longer in \OS2\DLL but in the directory specified as the target
directory to hold the HOOK files. The only REQUIREMENT for LIBPATH is
that the first entry should be  ".;"  , i.e. the default directory.

In addiition the limitation on the directory name for the installation
has been modified and the directory name may be up to 60 characters
in length and may be specified with sub-directories.

Users booting OS/2 from a logical drive and with multiple versions
existing should no longer have any problems. Just be sure that the
active CONFIG.SYS has in its LIBPATH  command ".;" as the first entry.

All of these aspects and many more are detailed in the either of the
two documenting files below.

The two files  HOOK.TXT and HOOK.INF contain the same information but
HOOK.TXT is an ASCII text file and can be displayed with any Text Editor,
List command or the DOS type command.

HOOK.INF is an OS/2 PM file and can be viewed with the OS/2 view.exe
program. That program is by default in the \os2 directory on the
drive on which OS/2 is installed and \OS2 is almost certainly in the
Path listing. To view HOOK.INF with VIEW just enter from an OS/2 command
line where the default directory has HOOK.INF    View hook.

Either file contains instructions on Installation of HOOK as well as
details about its use.

If you want to use the assignments in an existing HOOK.DAT file, after
this new version is installed, copy that file to the directory holding
HOOK.EXE. When HOOK is loaded use Shift-Ctrl-UpArrow to read in that file.
Then use Shift-Alt-DnArrow to save the assignments just readin into
HOOK.HKY.

Tue  02-06-96

Morton F. Kaplon