home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / fixkey.zip / readme.txt < prev    next >
Text File  |  1994-04-04  |  4KB  |  94 lines
  1. FIXKEY 1.0 USER DOCUMENTATION
  2. ______________________________________________________________________
  3.  
  4. INTRODUCTION
  5. ------------
  6.  
  7. Fixkey is designed to fix OS/2's very annoying problem of not
  8. recognizing certain keys on some 101 keyboards. The keys that do not
  9. work in PM sessions are: insert, delete, home, end, pgup, pgdn, arrow
  10. keys, F11, F12, keypad enter, keypad '/', right alt and right
  11. ctrl. The cursor keys on the numeric keypad work fine. This problem
  12. manifests itself unpredictably, and only in PM sessions. The cause of
  13. this problem is that some keyboards that do not follow IBM
  14. specifications: see APAR PJ11673 for details. Sometimes, the problem
  15. is caused by an old BIOS. Whatever the case, OS/2 detects a PC/AT
  16. keyboard, not an extended 101/102. No fixes will be forthcoming from
  17. IBM, according to this document.
  18.  
  19. With Fixkey, this problem is alleviated. Once installed, usage is
  20. simple: just start fixkey.exe. That's it. The grey cursor keys should
  21. work. To unload this program, kill the Fixkey PM window in the usual
  22. way: double click on the window corner, or choose "close" from its
  23. system menu or task list.
  24.  
  25. INSTALLATIION
  26. -------------
  27.  
  28. First, you might want to check if Fixkey will fix your particular
  29. problem.  I have already described the symptoms. To be sure, run a
  30. diagnostic to see what keyboard OS/2 detects. The free diagnostic in
  31. qconfg.zip from IBM's EWS distribution will tell you this. Get
  32. qconfg.zip from software.watson.ibm.com or ftp.cdrom.com
  33. (os2/ibm/ews/qconfg.zip).
  34.  
  35. File list:    fixkey.exe
  36.         fixhook.dll
  37.         source.zip (zipped source code)
  38.         readme.txt (this file)
  39.  
  40. Place fixhook.dll in a directory on your libpath, such as \os2\dll, or
  41. in the same directory as fixkey.exe. Fixkey.exe should, in turn, be
  42. placed in a directory on your path or someplace where you can easily
  43. run it. 
  44.  
  45. COMMENTS
  46. --------
  47.  
  48. I am severely lacking in experience in this sort of thing. I have
  49. never written publicly distributable software, so please excuse any
  50. lack of polish. Even more important, this is my first OS/2
  51. program. See disclaimer to sufficiently alarm yourself :-). 
  52.  
  53. Fixkey should only affect PM sessions. If your keyboard does not work
  54. right in text windows or Dos sessions, you have a different problem
  55. from what I am trying to solve. Also, Fixkey does not appear to be
  56. active in the task list called by ctrl-esc. Finally, Fixkey does not
  57. fix the right ctrl and alt keys. While this is possible, it is more
  58. work than I believe it justifies. Since I have included the source
  59. code, other aspiring programmers are welcome to take over the task.
  60.  
  61. The source code was compiled using IBM's Cset++ FirstStep compiler, in
  62. C (except for the '//' comments). There should not be anything
  63. specific to the compiler, except for the (simplistic) makefile. The
  64. kbdscan.h file comes from Eberhard Matte's EMX/GCC distribution. 
  65.  
  66. LICENCE
  67. -------
  68.  
  69. I can't believe I am writing this. Ah well, basically you can
  70. redistribute it freely, with no restrictions. There is no charge for
  71. use of this program. I only ask that this document be distributed with
  72. the program unchanged.
  73.  
  74. DISCLAIMER
  75. ----------
  76.  
  77. Here is where I cover my behind. This program is provided "as is",
  78. without warranty of any kind, either expressed or implied, including,
  79. but not limited to, the implied warranties of merchantability and
  80. fitness for a particular purpose. The entire risk as to the quality
  81. and performance of the program is with you. Should the program prove
  82. to be defective, you assume the cost of all necessary servicing,
  83. repair or correction. In no way will I be liable to you for damages,
  84. including any general, special, incidental or consequential damages
  85. arising out of the use or inability to use the program ...
  86.  
  87. ... oh heck. I am sick of typing. Just read the disclaimer portion of
  88. the infamous GNU General Public Licence. Remember, you get what you
  89. pay for :-).
  90.  
  91. Christopher Wong
  92. 25 Myrtle Ave
  93. Cambridge, MA 02138.
  94. wong1@husc4.harvard.edu