home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug048.arc / KWIKEY.DOC < prev    next >
Text File  |  1979-12-31  |  4KB  |  101 lines

  1. DOCUMENTATION FOR KWIKEY.MWB, by Julian Loke, 1987Jan04
  2. Keyboard Macro Utility
  3.  
  4. Noticσ ª disclaimer
  5.  
  6.      Permissioεá i≤á hereb∙ granteΣ fo≥ privatσá non-commercia∞ ì
  7. usσ oµ thi≤ prograφ a≤ is«  Fee∞ freσ t∩ givσ i⌠ awa∙ i⌠ intac⌠ ì
  8. witΦ copyrigh⌠ anΣ documentation«á  N∩ distributioε fo≥á profi⌠ ì
  9. i≤á alloweΣ withou⌠ thσ author'≤ expres≤ permission¼á anΣá thi≤ ì
  10. wil∞á NO╘ bσ given«á  Iµ yo⌡ paiΣ mone∙ fo≥ thi≤ publiπá domaiε ì
  11. software¼ YO╒ werσ rippeΣ off!
  12.  
  13. Introduction
  14.  
  15.      Man∙á oµá yo⌡ wil∞ bσ familia≥ witΦ thσá ke∙á redefinitioε ì
  16. memory-residen⌠á utilit∙ Qwike∙ (C⌐ b∙ Ton∙ Fleiτ fo≥ thσá CP/═ ì
  17. operatinτá system«á  Wouldn'⌠á i⌠ bσ nicσ iµ ßá simila≥á publiπ ì
  18. domaiε utilit∙ werσ availablσ fo≥ MicroworlΣ Tin∙ BASIC«á  Thi≤ ì
  19. filσ describe≤ sucΦ aε overlay¼á KWIKEY¼ anΣ it≤ loade≥ writteε ì
  20. iε MicroworlΣ tin∙ BASIC.
  21.  
  22. Keyboard macros
  23.  
  24.      Yo⌡ migh⌠ finΣ tha⌠ yo⌡ havσ t∩ typσ thσ samσ sequence≤ oµ ì
  25. character≤ quitσ ofteε durinτ ß computinτ session«á  ┴ keyboarΣ ì
  26. macr∩á utilit∙á allow≤ yo⌡ t∩ redefinσ ß singlσ ke∙ s∩ tha⌠á i⌠ ì
  27. caε meaε an∙ sequencσ oµ character≤ yo⌡ wish«  Fo≥ example¼ yo⌡ ì
  28. migh⌠ redefinσ thσ TA┬ ke∙ t∩ thσ character≤ "LIS╘ "¼á o≥á eveε ì
  29. thσ B╙ ke∙ t∩ bσ thσ samσ a≤ DEL.
  30.  
  31. Usage
  32.  
  33.      Ruεá thσ prograφ KWIKEY.MW┬ anΣ yo⌡ wil∞ bσ prompteΣ fo≥ ß ì
  34. ke∙ whicΦ i≤ t∩ bσ useΣ a≤ aε attention-terminatioεá character«  ì
  35. ┴ shor⌠ timσ afte≥ typinτ thi≤ key¼á thσ KWIKE┘ overla∙ wil∞ bσ ì
  36. installed¼ afte≥ whicΦ thσ loade≥ prograφ wil∞ removσ itself.
  37.  
  38.      A⌠á thi≤á stage¼á thσá overla∙ i≤á active¼á bu⌠á i≤á quitσ ì
  39. transparen⌠á t∩ BASI├ anΣ thσ onl∙ differencσ you'l∞ noticσá i≤ ì
  40. tha⌠ keyclicδ i≤ present.
  41.  
  42.      Wheεá yo⌡á wisΦá t∩ redefinσ ß key¼á typσá thσá attention-ì
  43. terminatioε character«  Thσ to≡ linσ o≥ line≤ oµ thσ screeε arσ ì
  44. madσ blanδ anΣ ß promp⌠ appears«á  No≈ typσ thσ ke∙ yo⌡ wisΦ t∩ ì
  45. bσá redefined«á  Wheεá yo⌡ ge⌠ thσ nex⌠ prompt¼á typσá thσá ne≈ ì
  46. sequencσá oµ character≤ yo⌡ wisΦ t∩ replacσ thσ olΣá key«á  Thσ ì
  47. ke∙ code≤ yo⌡ arσ typinτ wil∞ appea≥ oε thσ to≡ line«á  Contro∞ ì
  48. code≤á appea≥á a≤ thσ RO═ graphic≤ characters«á  Wheεá yo⌡á arσ ì
  49. finished¼á typσ thσ attention-terminatioε characte≥ again«  Thσ ì
  50. screeε i≤ restored¼á anΣ yo⌡ ma∙ no≈ usσ thσ redefineΣ ke∙ a≤ ß ì
  51. macro.
  52.  
  53.      Notσá tha⌠ yo⌡ canno⌠ redefinσá thσá attention-terminatioε ì
  54. key¼ no≥ caε yo⌡ usσ i⌠ withiε ß macro«  Therefore¼ choosσ thi≤ ì
  55. ke∙ witΦ care«á  ╔ sugges⌠ yo⌡ usσ key≤ no⌠ otherwisσ needeΣ b∙ ìèBASIC¼ sucΦ a≤ NU╠ (ctrl-@)¼ o≥ U╙ (ctrl-DEL).
  56.  
  57.  
  58. How it works
  59.  
  60.      Thσá principlσá i≤ quitσ simple¼á bu⌠ don'⌠ worr∙á iµá yo⌡ ì
  61. don'⌠á understanΣ i⌠ becausσ tha⌠ ha≤ neve≥ beeε ß prerequisitσ ì
  62. fo≥ usinτ software«á Iε al∞ curren⌠ version≤ oµ MicroworlΣ tin∙ ì
  63. BASIC¼á al∞á inpu⌠ i≤ vectoreΣ througΦ thσ INPU╘á VECTO╥á tablσ ì
  64. froφá 00C2Φ (194d⌐ t∩ 00D1Φ (209d)«á  KWIKE┘ trap≤ thσ keyboarΣ ì
  65. inpu⌠á vecto≥á 0¼á anΣ use≤ thσ code≤ t∩ inde°á int∩á ßá macro-ì
  66. definitioε table«  Wheε BASI├ ask≤ fo≥ ß key¼ thσ code≤ i⌠ get≤ ì
  67. comσ froφ thσ tablσ entr∙ fo≥ thσ las⌠ ke∙ pushed.
  68.  
  69.      WitΦ thσ exceptioε oµ thσ attention-terminatioε character¼ ì
  70. eacΦ oµ thσ 12╖ key≤ ha≤ it≤ owε redefinablσ sequence«á  Wheε ß ì
  71. ke∙ i≤ redefined¼ thσ macro-definitioε tablσ i≤ updated«  Therσ ì
  72. i≤ ß limi⌠ t∩ thσ sizσ oµ thσ tablσ (102┤ bytes)¼á anΣ thi≤ anΣ ì
  73. thσá maximuφ sizσ oµ eacΦ macr∩ (6┤ bytes⌐ caε bσ defineΣá wheε ì
  74. yo⌡ firs⌠ loaΣ KWIKEY«  
  75.  
  76.      Thσá overla∙ sit≤ a⌠ thσ enΣ oµ use≥ memory¼á belo≈ BASIC¼ ì
  77. anΣ abovσ thσ stack«á  Thσ relocatinτ loade≥ wil∞ determinσ thσ ì
  78. sizσá oµ memor∙ fo≥ itself¼á anΣ wil∞ placσ itselµ belo≈á othe≥ ì
  79. memor∙ residen⌠ utilitie≤ (sucΦ a≤ CKSM22)«á  T∩ removσ KWIKEY¼ ì
  80. yo⌡ wil∞ havσ t∩ reboo⌠ BASIC.
  81.  
  82. Improvements
  83.  
  84.      I⌠á shoulΣ bσ possiblσ t∩ writσ utilitie≤ tha⌠á wil∞á savσ ì
  85. anΣ retrievσ thσ curren⌠ macro-definitioε table.
  86.  
  87. Distribution
  88.  
  89.      Thσá file≤á KWIKEY.MW┬ anΣ KWIKEY.DO├ havσá beeεá uploadeΣ ì
  90. ont∩á thσ MBU╟ RCP/═ (Melbournσ 03-8821571¼á 7*24h)«á  Yo⌡á caε ì
  91. als∩ arrangσ t∩ ge⌠ ß cop∙ froφ mσ a⌠ onσ oµ thσ cluΓ meetings«  ì
  92. A≤ ß fina∞ resort¼á thσ filσ KWIKEY.MW┬ i≤ reproduceΣ belo≈ fo≥ ì
  93. yo⌡ t∩ ente≥ b∙ hand«  Pleasσ observσ thσ noticσ anΣ disclaime≥ ì
  94. above.
  95.  
  96.      Pleasσá direc⌠ an∙ questions¼á enquiries¼á o≥ request≤ fo≥ ì
  97. thσ Z8░ assembl∙ languagσ sourcσ fo≥ thσ overla∙ t∩ mσ vißá thσ ì
  98. cluΓ magazinσ o≥ RBBS.
  99.  
  100. END OF DOCUMENTATION
  101.