home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / pmkey5.zip / pmkey.doc < prev    next >
Text File  |  1995-08-15  |  7KB  |  140 lines
  1.  
  2.            PMKey v0.04 Copyright (C) 1995 Henry Palmroos.
  3.  
  4.                            !!! WARNING !!!
  5.  
  6.     PMKey is FREEWARE program, only thing i'm asking from you, is if
  7. you like it please send me a POSTCARD. And because PMKey is FREEWARE
  8. program there is NO WARRANTY OF ANY KIND. If this program blows your
  9. house, destroys your machine, or cause WW III don't blame me! Use this
  10. program at your own risk! If you don't agree with these terms you are
  11. not allowed to use this program, please remove it from your hard disk!
  12.  
  13.     Also you can't include PMKey in any commercial product (or sold
  14. it) without my permission! THERE IS ONE EXCEPTION: YOU CAN INCLUDE
  15. PMKEY IN SHAREWARE/PD CD-ROM COLLECTIONS FREELY, WITHOUT MY
  16. PERMISSION.
  17.  
  18.     With PMKEY04.ZIP you received EMX.DLL, it's not part of PMKey
  19. and is distributed under GNU General Public License, see COPYING
  20. file.
  21.  
  22. -------------------------------------------------------------------------------
  23.  
  24.                              Installation
  25.  
  26.     UNZIP PMKEYxx.ZIP, copy PMKEYDLL.DLL & EMX.DLL to OS2\DLL or in
  27. any directory that is in LIBPATH and start PMKEY. PMKEY will create
  28. PMKEY.DAT file in PMKEY startup directory, for example: if PMKEY is in
  29. directory D:\PMKEY, PMKEY will create PMKEY.DAT file in directory
  30. D:\PMKEY. PMKEY will also load PMKEY.DAT from directory where PMKEY is
  31. in.
  32.  
  33.     After unzipping packet (remember if you are using PKWARE PKUNZIP
  34. use option -D to create directorys!!! Info-Zip UNZIP creates
  35. directorys automatically) you have Warp directory where is executables
  36. for OS/2 Warp (see end of this document) and in the "root" directory
  37. there is executables for all OS/2 2.X versions. PMKEY.EXE is PMKEY
  38. version that has OS/2 FULLSCREEN detection capability, and PMKEYWF is
  39. version that uses only 32-bit functions, so it can't detect keys from
  40. OS/2 FULLSCREEN sessions.
  41.  
  42. -------------------------------------------------------------------------------
  43.  
  44.     First i must apologize my very bad english. (I'm from Finland).
  45. But hopefully you can understand something :). This is my first "real"
  46. OS/2 PM program, so don't expect much from it. And also, there is
  47. probably lots of bugs. My biggest problem is in the 16-BIT API calls,
  48. because PMKey can detect keys from fullscreen os/2 sessions it means
  49. i have to use DosMonReg / DosMonRead etc. 16-BIT function calls. So i
  50. have included also version of PMKey which doesn't have fullscreen
  51. detection capability. It should work in any OS/2 2.X version without
  52. problems.
  53.  
  54.     PMKey is very easy to use. Just select key from the Keys listbox
  55. and double click (or press enter). PMKey will bring dialog box asking
  56. you to type the name of the Window/Task. There is also tasklist
  57. listbox in the same dialog. Just double click from the tasklist and PM
  58. Key will copy the task name in to your entry field, and then press OK
  59. if you are happy with your selection. If your program doesn't show up
  60. in the tasklist try pressing RESCAN, PMKey will now rescan whole
  61. tasklist and add any new tasks into the list. You can save your hotkey
  62. list by pressing "Save List" button. (PMKey will automatically save
  63. your list when you exit the program, you can prevent saving in OPTIONS
  64. dialog).
  65.  
  66.    In options dialog you can select two options. Start minimized means
  67. that next time when you start PMKey it starts minimized. Second
  68. option is "Save list at exit", it means what i says :). For Example:
  69. if you have been testing PMKey, and added / removed Window Names and
  70. don't want to save list. PMKey will warn you at exit if "Save list at
  71. exit" is not selected.
  72.  
  73.     If you have program that uses ALT+0 -> ALT+9, or CTRL-0 -> CTRL+9
  74. keys you can press left shift while pressing hotkey to ignore it. This
  75. way PMKey will not interfere with your favorite program.
  76.  
  77.     PMKey is only tested with OS/2 Warp. But i can't see any reason
  78. why it wouldn't work with any OS/2 2.x version (?). In the ZIP packet
  79. there is also Warp executable which uses OS/2 Warp new packing system.
  80. If i have understand right, OS/2 2.x version can pack only resources
  81. in executables, but Warp can pack code also. Size difference isn't
  82. much between PMKEY.EXE's, but in big application the difference is of
  83. course bigger.
  84.  
  85.  Version History:
  86.  
  87. - 0.01  First version, i did have some problems with 16-BIT keyboard
  88.         routines, don't know why but i tried also [QUICKSWITCH 1.2 (C)
  89.         CLAUDE BIRON] (PMKey like program) and it did exactly same as
  90.         PMKey. First internal speaker of my computer beeped (?!?),
  91.         then the keyboard slowed down and started to lose characters,
  92.         huh, odd ???. And even when i removed my program (or
  93.         QuickSwitch) from memory, the keyboard still was slow and did
  94.         lose characters. OS/2 was also much slower, seems like OS/2
  95.         keyboard handler was in some kind busy loop??
  96.  
  97. - 0.02  I did make some small changes in PMKey, and also increased
  98.         keyboard buffers, and started to use two threads instead one
  99.         in keyboard routine. Now PMKey seems to be working right, at
  100.         least i haven't been able to crash keyboard with HYPERVIEW, or
  101.         without it.
  102.  
  103. - 0.03  Major changes.
  104.  
  105. - 0.04  Small changes, first public release.
  106.  
  107.     You can test if PMKey fullscreen keyboard handler crashes by
  108. downloading [HYPERVIEW V1.04 (C) MICHAEL H. SHACTER] program. I was
  109. able to crash version 0.01 in HyperView by simply pressing many times
  110. arrow up and arrow down keys at the same time, sounds weird ?. And i
  111. was able to crash my keyboard also with QuickSwitch program. So it
  112. seems that this isn't PMKey's problem. If somebody could explain this
  113. to me... eh? Well, of course HYPERVIEW isn't only program that could
  114. cause problems with PMKey, in fact HYPERVIEW is very good and FAST
  115. text viewer. I'm referring to HYPERVIEW just because i noticed PMKey
  116. problems while using it. There isn't nothing wrong in the HYPERVIEW.
  117. It's probably my crappy program causing problems :).
  118.  
  119.     If you notice that PMKey will crash your keyboard very often, try
  120. using PMKey version that doesn't have FullScreen detection capability.
  121. It should work without any problems because it uses only 32-bit 2.X
  122. function calls.
  123.  
  124.     PMKey is coded using GNU GCC compiler.
  125.  
  126. -------------------------------------------------------------------------------
  127.  
  128. So, if you like PMKey please send postcard to address:
  129.  
  130. Henry Palmroos
  131. Puosunrinne 6b 34
  132. Espoo 02320
  133. Finland
  134.  
  135. You can reach me from e-mail address:
  136.  
  137. asundber@vipunen.hut.fi
  138.  
  139. -------------------------------------------------------------------------------
  140.