home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / hook57.zip / readme.1st < prev    next >
Text File  |  1996-09-20  |  14KB  |  288 lines
  1. Information for HOOK  vs 5.6                        Sun  09-15-96
  2.  
  3. ------------------------------- INSTALLATION -------------------------------
  4.  
  5. From the directory containing the UNZIPPED files as the current directory
  6.  
  7.     type   INSTALL
  8.  
  9. and follow the directions and prompts from the Install Program.
  10.  
  11. !! DO NOT install this into the same directory as any current version    !!
  12. !! of HOOK. If you wish to retain the same name for the directory in     !!
  13. !! which to Install, then move the current content to another directory. !!
  14. !! or rename the directory containing the earlier the current version.   !!
  15.  
  16. !!! AFTER HOOK is installed DO NOT rename the  directory or any of the  !!!
  17. !!! files relating to HOOK. When HOOK is installed it copies the name   !!!
  18. !!! of the directory into which it is installed into HOOK.EXE and that  !!!
  19. !!!           information is required when HOOK is loaded,              !!!
  20.  
  21. I believe this version has all the problems with switching to loaded
  22. Hot Key programs fixed as well as the maintenance of the files
  23. HOOK.INI and HOOK.HKY. It has modified the way PM type programs
  24. are handled and includes new HOOK window messages and display behavior.
  25. When a Program is FIRST loaded by HOOK, the HOOK window will FLASH and
  26. display the Message HOOK BUSY until the critical part of the program load
  27. has occured. When the HOOK window stops flashing then it is safe to active
  28. another HotKey.  The time for a Program to Load is highly dependent on
  29. the particular program and happen almost instantaneously or take seconds
  30. to complete. This version of HOOK attempts to serialize the loading of
  31. programs so that a new program load is not started until the current
  32. program being loaded has completed it load.
  33.  
  34. NB:There is now an option to Turn Off the  Beeps accompanying the
  35.    Flashing. HOOK Window when a Program is Loaded.
  36.  
  37. There are some very few programs that do not install into the Task List.
  38. Since HOOK uses the Task List for its information on Program Loading and
  39. Unloading these cause a problem. That is handled by the use of a Timer.
  40. When any HOOK program is loaded, a Timer is started that turns off the
  41. Flashing Window and resets some other crucial parameters of HOOK so that
  42. it will continue to function normally. This time delay is set at 10
  43. seconds.
  44.  
  45. I have included a section in HOOK.INF (HOOK.TXT) on how HOOK works.
  46.  
  47. This is a significantly Updated Version and you should read the documentation
  48. before Installing or Using It.
  49.  
  50. Significant Capabilities have been added to HOOK.
  51.  
  52. New   A mapping of the HotKey Combinations has been made to create an
  53. 5.7   option to the Shift-Alt-X,Shift-Ctl-X,Alt-Ctl-X that is just a
  54.       two key combination Key-X. The purpose is to by pass conflicts
  55.       with program defined combinations using Alt-X or Ctl-X keys.
  56.       The current combinations are still in effect but the new Key-X
  57.       combinations can be used in place of them.
  58.  
  59.       The mappings are:  Shift-Alt-X   ->  ScrollLock-X
  60.                          Shift-Ctl-X   ->     NumLock-X
  61.                            Alt-Ctl-X   ->       Pause-X
  62.  
  63.       Keyboard handling is done so that if the alternates are used,
  64.       their state (and the LED state) is maintained.
  65.  
  66. >>    This modification makes the use of the Alt-Pause,Shift-Pause
  67. >>    unnecessary but it is still supported. However, the addition of
  68. >>    the Pause Key as a Hot-Key makes its use with Alt/Shift cumbersome
  69. >>    requiring multiple entries to access it. Its use is not recommended.
  70.  
  71. NEW   A PASTE mode has been added to HOOK. The built in HotKey Alt-Ctl-5
  72. 5.6   toggles this mode On/Off. When the PASTE Mode is Active the HOOK
  73.       oowindow Flashes and the Title Bar is changed to display PASTE.
  74.  
  75.       When ON the HotKeys (user defined) PASTE user defined text into
  76.       the current window. The text to paste is defined by the User using
  77.       the same HotKey sequences as for the normal Hot-Key operation and
  78.       activated by the HotKey assigned to that Text.
  79.  
  80.       The Text string, is in a formatted form using <...> to allow the
  81.       inclusion of various Control Keys (in general these are recognized
  82.       only in PM windows) and the total string length is up to 296
  83.       Characters. Each string may have a Description attached to it and
  84.       these descriptions can be displayed using the same key
  85.       combinations (in the Paste Mode) as used for the Normal HotKeys.
  86.  
  87. NEW   HOOK will read in a formatted Text File that allows Control type
  88. 5.5   keys to be pasted into PM windows(that accept text). The same
  89.       type of formatting can also be assigned to a HotKey if it is
  90.       preceeded by a ':'. The formatting is of the form <KeyName>
  91.       where KeyName is usually the label on the Keyboard. Included
  92.       also is a <Wait> and a <DosBeep> option formatted as
  93.       <Wait ###.###> and <! freq,duration>. There is also a comment
  94.       option formatted as <* Comment>
  95.  
  96.       Reading in the formatted Text File is initiated by Shift-Alt-F5
  97.       which brings up a FileDialog Window to obtain the name of the file.
  98.  
  99.       See the OnLine Help File Under   HOT-KEY Assignments-Fixed by Program
  100.  
  101. NEW   An ICON to start HOOK will now be installed by the INSTALL Program.
  102. 5.0
  103.  
  104. REDESIGN of Access to HotKey Menu for Assigning HotKey
  105.       Shift-Alt-F3 now brings up Window Prompting User to Type In
  106.       Hot-Key to Assign/Edit and identifies HotKeys
  107.  
  108. ASSIGN HotKey to Window on DeskTop (OS/2 PM and TEXT only)
  109.       Assigned to Hot-Key Shift-Alt-F9
  110.  
  111.  
  112. CLOSE All Program Started by HOOK - Assigned to Shift-Ctrl-Del
  113.       This option will close all programs that were loaded from a
  114.       HOOK Hot Key.
  115.  
  116. CLOSE Active Program - Assigned to Alt-Ctrl-End
  117.       This will close the Active Window (PM,OS/2 or DOS)
  118.  
  119. PASS  STARTUP HOT KEY to HOOK to Call After Loaded
  120.        When Hook is loaded a HotKey to Execute by HOOK can be passed
  121.        to HOOK on the Command Line to Execute after HOOK is loaded.
  122.  
  123. PASTE TEXT STRINGS INTO Windows
  124.        Text Strings may be assigned to HotKeys and when that HotKey is
  125.        struck the assigned text is pasted into the window with the
  126.        Keyboard Focus. There are two options for this. One pastes very
  127.        rapidly and the other with a very small time delay between
  128.        characters om the string.
  129.  
  130. EXECUTE SEQUENCES OF HOT Keys
  131.        This is a macro like capability that does not require recording.
  132.        A sequence of HotKeys may be assigned to a single HotKey and all
  133.        will be executed when that HotKey is struck. BE sure and read
  134.        the documentation on this.
  135.  
  136. SCHEDULE Hot Keys Option
  137.        This is a completely new addition which allows the user to
  138.        Schedule any assigned Hot Key for execution at a specified
  139.        time (hh:mm AM or PM) on any, all or selected days of the
  140.        week. At the  specified time the  program is executed just
  141.        as if the Hot Key key strokes had been entered at the Keyboard.
  142.  
  143.    IN ADDITION PLEASE NOTE THE FOLLOWING CHANGES FROM EARLIER VERSIONS
  144.  
  145. MACRO RECORDING now omits WM_MOUSEMOVE messages.
  146.          This speeds up playback and loses nothing since those messages
  147.          just display the mouse pointer moving from one location to
  148.          another. The actions at the end of that are unchanged.
  149.  
  150. MACRO PLAYBACK started by Shift-Ctrl-Ins within HOOK may be terminated
  151.          by pressing the Esc Key.
  152.  
  153. PLAYKEYS.EXE IS NO LONGER INCLUDED.
  154.          The format of this program is not compatible with the new
  155.          installation of HOOK BUT more importantly, its task has been
  156.          superseded by the PASTE TEXT STRINGS INTO Windows option.
  157.  
  158. HOOKQDLL.DLL HAS BEEN CHANGED.
  159.          The change is required to accomodate a new configuration parameter.
  160.          See below for those additions.
  161.  
  162. HOOK.INI HAS BEEN CHANGED.
  163.          In order to save the additional configuration parameters HOOK.INI
  164.          has increased in size. In addition some reserve bytes have been
  165.          added for potential future use.
  166.  
  167. HOOK DISPLAY WINDOW
  168.          Now displays messages when HOOK is loading/switching programs.
  169.          Message indicates that a program is being loaded or if
  170.          switching the technique used for Switching .i.e.SwitchList Handle.
  171.          (the Task List title is no longer used by HOOK).
  172.  
  173. USER ASSIGNABLE HOT-KEYS ADDED
  174.          Two new user assignable Hot Keys have been added. This results
  175.          in HOOK.HKY increasing in size by 2*278 bytes. They are 2-Char
  176.          Hot-Keys  Alt-Pause and Shift-Pause. In HOOK.DAT they may
  177.          entered as Pse-A and Pse-S for assignment.
  178.  
  179. DEFINE HOT KEYS ENTRY SCREEN
  180.          This has been significantly changed to display current
  181.          assignments of a Hot Key for Editing.
  182.  
  183. HOOK.HKY BINARY FILE STORING HOY-KEY INFORMATION.
  184.          Automatically read in when HOOK loaded and saved when HOOK
  185.          unloaded. If you want to read this, use a HEX editor.
  186.  
  187.          BE sure and use the new one and use HOOK.DAT to read old
  188.          settings back in.
  189.  
  190. HOT-KEY TASK MODIFIED:Shift-Alt-UpArrow
  191.         Shift-Alt-UpArrow no longer reads in HOOK.DAT. It now reads in
  192.         HOOK.HKY from disk.
  193.  
  194. NEW BUILT IN HOT-KEY:Shift-Ctl-Del
  195.         This Hot-Key will CLOSE ALL Programs Started using HOOK.
  196.         It DOES NOT close HOOK. This is a quick way to clean the
  197.         Desk Top.
  198.  
  199. NEW BUILT IN HOT-KEY:Shift-Ctl-UpArrow
  200.         HOOK.DAT is now read in by Shift-Ctl-UpArrow. In addition
  201.         HOOK.DAT is NOT automatically read in when HOOK is loaded but
  202.         may be read in as indicated above. Any assignments in HOOK.DAT
  203.         will overwrite those currently in effect.
  204.  
  205. NEW BUILT IN  HOT-KEY:Alt-Ctrl-Esc
  206.         In this version of HOOK, when HOOK is loaded the 3-Key sequence
  207.         Ctrl-Alt-Del that is used for rebooting is disabled (by using a
  208.         DosDevIOCtl Command). In its place this Hot-Key will display a
  209.         message asking "Do You Really want to REBOOT ?" and informing
  210.         you that if the answer is Yes, it will re-enable Ctl-Alt-Del
  211.         BUT that no HOOK files will be saved. I have included this option
  212.         because the Built in Hot-Keys Shift-Alt-End and Shift-Alt-Del
  213.         may sometimes be inadvertenlty hit as Ctrl-Alt-Del ( I have one it
  214.         on some occasions) and this then will not allow that to happen
  215.         and any attempt to reboot will give you a warning message.
  216.  
  217.         NB. DISABLING Ctl-Alt-Del also DISABLES Alt-Home which in a DOS
  218.         window allow switching between a DOS window and DOS Full Screen.
  219.  
  220.         Some problems may have occured with using OBJOPEN or PLAYBACK
  221.         because of some inconsistencies in Command Line formatting
  222.         between the 4OS2.EXE COMMAND PROCESSOR (which is what I use)
  223.         and CMD.EXE (the default from IBM). These have now been fixed.
  224.  
  225. NEW CONFIGURATION OPTIONS in Shift-Alt-F2 ACTIVATED MENU.
  226.         BEEP accompanying Flashing Window when Program Loaded
  227.           An option is included to turn this OFF or ON(default)
  228.  
  229.         Message Display KeyPad Use Options
  230.           An additional option to toggle OFF/ON the BEEP when HOOK
  231.           is loaded.
  232.  
  233.         New Menu Option for DLL
  234.           Toggle OFF/ON how HOOKQDLL treats WM_CHAR messages. Currently
  235.           WM_CHAR messages indicating a Hot-Key entered from KeyBoard
  236.           are NOT PASSED on to System Message Queue. This option allows
  237.           that behavior to be changed.
  238.  
  239.         Display Scheduled Hot Keys
  240.           This lists on the screen the Hot Keys that are currently
  241.           scheduled and the specifics of the Schedule for that Hot Key.
  242.           (see above for that new option)
  243.  
  244. This version is backward compatible with earlier versions except as
  245. noted above with respect to the files HOOKQDLL.DLL, HOOK.INI  and
  246. HOOK.HKY .
  247.  
  248. The INSTALL program has been modified to copy the readme.1st file to
  249. the target directory as well as the two DLL files. The DLL files are
  250. now no longer in \OS2\DLL but in the directory specified as the target
  251. directory to hold the HOOK files. The only REQUIREMENT for LIBPATH is
  252. that the first entry should be  ".;"  , i.e. the default directory.
  253.  
  254. The Install program will now accept any valid directory name sequence
  255. up to 60 characters (including the drive  specificaton) in length.
  256.  
  257. Users booting OS/2 from a logical drive and with multiple versions
  258. existing should no longer have any problems. Just be sure that the
  259. active CONFIG.SYS has in its LIBPATH  command ".;" as the first entry.
  260.  
  261. All of these aspects and many more are detailed in the either of the
  262. two documenting files below.
  263.  
  264. The two files  HOOK.TXT and HOOK.INF contain the same information but
  265. HOOK.TXT is an ASCII text file and can be displayed with any Text Editor,
  266. List command or the DOS type command.
  267.  
  268. HOOK.INF is an OS/2 PM file and can be viewed with the OS/2 view.exe
  269. program. That program is by default in the \os2 directory on the
  270. drive on which OS/2 is installed and \OS2 is almost certainly in the
  271. Path listing. To view HOOK.INF with VIEW just enter from an OS/2 command
  272. line where the default directory has HOOK.INF    View hook.
  273.  
  274. Either file contains instructions on Installation of HOOK as well as
  275. details about its use.
  276.  
  277. If you want to use the assignments in an existing HOOK.DAT file, after
  278. this new version is installed, copy that file to the directory holding
  279. HOOK.EXE. When HOOK is loaded use Shift-Ctrl-UpArrow to read in that file.
  280. Then use Shift-Alt-DnArrow to save the assignments just readin into
  281. HOOK.HKY.
  282.  
  283. Sun  09-15-96
  284.  
  285. Morton F. Kaplon
  286.  
  287.  
  288.