home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / k / keycac03.zip / KC.DOC < prev    next >
Text File  |  1992-03-23  |  10KB  |  217 lines
  1.                       KEYCACHE--A TSR WORD PREDICTOR
  2.  
  3. Keycache is a small TSR program that accelerates keyboard input by looking 
  4. at what you have typed and showing you a list of words that start with it.  
  5. At the touch of a single key, Keycache will "type" the rest of the word.  
  6. Whenever you type a word that Keycache doesn't know about, it will be 
  7. stored in memory and displayed the next time you type something that could 
  8. match it.  Keycache increases keyboard input speed the same way a disk 
  9. cache speeds up disk accesses.
  10.  
  11. Keycache is especially useful for users who
  12. --Have learning disabilities that make spelling and word selection difficult
  13. --Have physical disabilities that slow down keyboard usage
  14. --Are using alternative input techniques like scanning
  15. --Are simply slow hunt-and-peck typists
  16. --Are working with programs that require highly "stereotyped" word input, 
  17.   such as databases that require field names to be spelled out.  Keycache
  18.   can be used to add pick-list capability to such programs.
  19.  
  20. Keycache was designed to work with almost any program that uses keyboard 
  21. input.  You can create your own vocabulary lists (for example, legal or 
  22. medical terms).  Keycache takes up only as much memory as you want it to, 
  23. and can be used in conjunction with other TSRs like macro programs or 
  24. alternative input programs.
  25.  
  26. To install Keycache, just type KC at the DOS prompt.  Keycache will load 
  27. itself and check to see if you have a dictionary file in the current 
  28. directory.  If so, Keycache will load in the words in the file.  If not, 
  29. Keycache will start with a "clean slate" and accumulate the words that you 
  30. type.
  31.  
  32. Whenever you type some letters that could be the start of a word that 
  33. Keycache knows about, a window will pop up and show you a list of numbered 
  34. (0-9) choices.  If you want to "type" one of the words shown, just press 
  35. the appropriate digit key.  If you don't want to pick one of the words, 
  36. just continue typing.  If you want to type a literal digit, press Escape 
  37. and the window will clear.  Keycache will enter the word in lowercase 
  38. unless you have the caps-lock key on, in which case it will enter it in all 
  39. uppercase.
  40.  
  41. Keycache can deal with words up to 32 characters long.  If a word has more 
  42. than 15 characters, only the first 15 will be shown in the window.  If more 
  43. than 10 words match, only the first 10 will be shown.  Keycache defines a 
  44. word as a string of letters.  Whenever you type a space, number or 
  45. punctuation symbol, Keycache will store the word.  The window will position 
  46. itself so as to avoid the line the cursor is on, since some word processors 
  47. insist on repainting the cursor line continuously.
  48.  
  49. Since Keycache accumulates the words that you type, you'll need to save 
  50. your list of words back to disk before turning off your computer; otherwise 
  51. words that you typed for the first time won't be remembered for your next 
  52. session.  To save your word list, type KC/W at the DOS prompt.  This will 
  53. replace any existing dictionary file with a new one.  You should be in the 
  54. same directory you were in when you started Keycache.
  55.  
  56. You can remove Keycache from memory by typing KC/U or KC/Q.  Be sure to 
  57. save your dictionary before doing this.
  58.  
  59. Keycache has a few options that can be invoked when you install it.  All of 
  60. them are indicated by typing a slash (/) followed by a letter on the 
  61. command line:
  62.  
  63. /2   Record 2-letter words.  Normally Keycache ignores 2-letter words since
  64. there would be no keystroke saving for them.  Some users with learning 
  65. disabilities may find display of 2-letter words useful, however.
  66.  
  67. /2-  Don't record 2-letter words.  This is the default setting.
  68.  
  69. /C fg bg  Set the foreground and background colors of the popup window.  fg 
  70. and bg are both decimal numbers from the following list:
  71.      0   black          8   gray         
  72.      1   blue           9   light blue  
  73.      2   green          10  light green
  74.      3   cyan           11  light cyan
  75.      4   red            12  light red
  76.      5   magenta        13  light magenta
  77.      6   brown          14  yellow
  78.      7   white          15  bright white
  79. On most video displays, colors 8-15 can be used for foreground only; trying 
  80. to use them for background will result in a blinking display.  The default 
  81. colors are white on black (7 and 0) for monochrome systems and blue on 
  82. green (1 and 2) for color systems.
  83.  
  84. /F   Don't record new words.  This is often called "fixed prediction."
  85.  
  86. /F-  Turn fixed prediction off and record new words.  This is the default 
  87. setting
  88.  
  89. /H nn  Display the window begining at column nn.  Acceptable values are 1 
  90. through 59.  The default value is 55.
  91.  
  92. /M nn  Reserve nn K of memory in addition to whatever is taken up by the 
  93. dictionary loaded from the file.  This area of memory will hold new words 
  94. that Keycache adds to the dictionary as you type them.  nn can range from 0 
  95. to 60, but Keycache will never use more than 64K total.  The default value 
  96. is 4K.
  97.  
  98. /R filename  Load the dictionary from the specified file.  If the filename 
  99. is omitted, Keycache will look for a file called "kc.dic" in your current 
  100. directory.
  101.  
  102. /S   Insert a space after any word "typed" by Keycache.
  103.  
  104. /S-  Don't insert spaces.  This is the default setting.
  105.  
  106. /U  Uninstall Keycache.  /Q is a synonym for this option.
  107.  
  108. /W filename  Save the dictionary to the specified file.  If you don't 
  109. include a filename, "kc.dic" in your current directory will be used.
  110.  
  111. You can have more than one option on a command line.  Once you have 
  112. Keycache loaded, you can subsequently use the /2, /2-, /S, /S- and /C 
  113. switches to change its behavior.  The /M and /R switches will be ignored if 
  114. Keycache is already resident, since resizing a resident program's memory is 
  115. not always possible.  The /W and /U switches are only available if Keycache 
  116. is already resident.
  117.  
  118. If you are using Keycache in conjunction with another TSR that affects 
  119. keyboard input (for example, a program that lets you point to an on-screen 
  120. keyboard matrix with a trackball to "type" characters), you should load 
  121. Keycache after the other TSR (otherwise Keycache won't see the characters 
  122. you enter with the alternate-input program).
  123.  
  124. Keycache dictionary files are plain ASCII text files with one word per 
  125. line.  If you create your own dictionary with a text editor, make sure that 
  126. words consist entirely of lowercase letters with no digits or punctuation 
  127. symbols.  Large dictionaries will load faster if all the words are in 
  128. alphabetical order (whenever you save a dictionary with the /W option, all 
  129. the words will be saved in order).
  130.  
  131. LIMITATIONS
  132.  
  133. Keycache will only work with programs that use BIOS services to get keys 
  134. (most do, but a few programs insist on reading the keyboard port directly).  
  135. Keycache doesn't know much about the context of what you type; if, for 
  136. example, you exit Word Perfect, type "N" in response to the prompt and then 
  137. type "dir," Keycache will think you typed "NDIR" and add it to its 
  138. dictionary.
  139.  
  140. Keycache tries to do everything it can to make sure that the window isn't 
  141. displayed at a time when the application program could overwrite it, but 
  142. some programs manage to sneak by it.  If this happens, you'll get a lousy- 
  143. looking display (when the window does clear, it will be replaced with 
  144. whatever was under it at the time it popped up, which may not match what's 
  145. currently being displayed); while ugly, this effect is harmless.
  146.  
  147. If there's no room in memory to add a new word, the current version will 
  148. ignore it.  Future versions will make room for new words by discarding 
  149. infrequently-used words.
  150.  
  151. LEGAL STUFF
  152.  
  153. Keycache and this manual are copyright 1991,1992 by OMS Development/Eric 
  154. Bohlman.  All rights reserved.  You may freely copy and distribute Keycache 
  155. as long as you include both the executable program and this manual and you 
  156. do not alter them in any way.  If you distribute Keycache, you may not 
  157. charge more than the actual cost of duplication.  You may not distribute 
  158. Keycache as part of a commercial package without written permission from 
  159. OMS Development
  160.  
  161. Keycache is distributed as shareware.  If you decide to use it on a regular 
  162. basis, you are required to register it.  Registration costs $40 (single 
  163. user) or $100 (all users on a single network) and entitles you to 
  164. automatically receive any upgraded versions of Keycache.  Registered 
  165. versions will include at least one default dictionary file to help you get 
  166. started.  To register, send the appropriate amount in US funds to:
  167.  
  168. OMS Development
  169. 1921 Highland Ave.
  170. Wilmette, IL  60091
  171. 708-251-5787
  172.  
  173. You may also register using your Visa or Mastercard by calling or writing:
  174.  
  175. Shareable Software International
  176. P.O. Box 59102
  177. Schaumburg, IL  60159
  178. 800-622-2793 (708-397-1221 outside the United States)
  179.  
  180. There is a $5 processing fee for credit card orders.  Be sure to include 
  181. the name as it appears on the card, card number and expiration date.
  182.  
  183. When registering, please specify 5.25" or 3.5" disks.
  184.  
  185. CONTACT INFO
  186.  
  187. I can be reached by snail-mail at the above address, by Genie Mail at 
  188. E.Bohlman, by Fido mail at 1:115/778 and by phone at (708)251-5787.  I 
  189. would appreciate any suggestions or bug reports.  I can usually be reached 
  190. by phone between noon and midnight Central time.  Ordinarily I can return 
  191. long-distance calls from registered users only.
  192.  
  193. VERSION HISTORY
  194.  
  195. 0.3 Added options for fixed prediction and window positioning
  196.  
  197. 0.2 (10/20/91)  Fixed bug that caused garbage to display when dictionary 
  198. size was a multiple of 128 characters.
  199.  
  200. 0.1 (7/13/91)   Initial release.
  201.  
  202. ABOUT OMS DEVELOPMENT
  203.  
  204. OMS Development specializes in the development of custom software and 
  205. hardware.  Since 1980, we have provided custom programming, hardware 
  206. product design and computer consultation to a wide range of clients.  Our 
  207. services have included designing specialized microprocessor-based 
  208. optometric instruments, writing Turbo Pascal database programs for the food 
  209. brokerage industry, installing LANs and writing custom DOS utilities.
  210.  
  211. We also market a variety of shareware programs including Tinytalk, a 
  212. powerful and memory-efficient screen reader for blind or dyslexic users who 
  213. use speech synthesizers, and Search, a flexible text retrieval system.
  214.  
  215. Eric Bohlman
  216. March 23, 1992
  217.