home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / editor / nbmaster.arc / MASTER.DOC next >
Encoding:
Text File  |  1989-11-09  |  8.3 KB  |  163 lines
  1. MAIL RECEIVED FROM BITNET GROUP RE: UPDATE OF NOTA BENE UTILITY:
  2. ----------------------------------------------------------------------
  3. ----------------------------------------------------------------------
  4. WALLENGREN'S MASTER PROGRAM REVISITED
  5. November 2, 1989
  6.  
  7. Wallengren's MASTERPM.RN creates macros (simple programs) on the fly.
  8. The program, once run, records (captures) all your operations,
  9. whether keyboard assignments or any combination of these with text.
  10. It then lets you assign it immediately to phrase key as well as save
  11. as permanent program. Program was initially written by Ernie
  12. Wallengren for (and with) XyWrite 3.1, uploaded in April 1986 to
  13. CompuServe and BIX (under the name "CAPTURE.PM"), adapted to Nota
  14. Bene, altered and augmented by Itamar Even-Zohar.
  15.  
  16. MASTERPM.RN was modified again October 28, 1989 with the help of an
  17. undocumented feature, reported by Jonathan Zuck
  18. (JZ_UFI@JHUVMS.BITNET). This feature is the command 'SAVE %phrase key
  19. number/letter' (1-9/A-Z). It writes to disk the contents of an
  20. indicated phrase. This has made it possible to eliminate the complex
  21. procedure of opening an alternative window, where the concatenated
  22. key-capture is written down, saved and then loaded on a key. The
  23. procedure is much simpler now: the concatenated phrase is saved on 0
  24. when concatenation is terminated (with PrtSc, as before), then 'SAVE
  25. %0' writes on disk a file called 0.SAV, which is then loaded (with
  26. LDPM command) on the key indicated by the user. It is then renamed,
  27. if user wishes to use it as a future program under a different name,
  28. or discarded, if user does not need it.
  29.  
  30. The new version will shortly be available from the file server, when
  31. I update UTILS.ARC. The older version will still be preserved under
  32. the name MASTERPM.OLD.
  33.  
  34. To order UTILS.ARC send command to LISTSERV@TAUNIVM (it may be sent
  35. as mail, file or interactive message). For further information on how
  36. to order files from the Notabene file server, read NOVICE.GUIDE.
  37. ------------------------------------------------------------------------
  38. ------------------------------------------------------------------------
  39. EXTRACT FROM UTILITIES DOCUMENTATION IN UTILS.ARC:
  40.  
  41. Updated August 12, 1989
  42.  
  43. Wallengren's Master Program
  44.  
  45. MASTERPM.RN
  46. Program allows you to create macros (simple programs) on the fly.
  47. The program, once run, records all your operations, whether
  48. keyboard assignments or any combination of these with text. It
  49. then lets you assign it immediately to phrase key as well as save
  50. as permanent program.
  51.  
  52. [Originally written by Ernie Wallengren for (and with) XyWrite
  53. 3.1, uploaded in April 1986 to CompuServe and BIX (under the name
  54. "CAPTURE.PM"), adapted to Nota Bene and altered and augmented by
  55. me. The text below is a slightly modified version of Wallengren's
  56. own explanation. Wallengren's own program, a beautiful piece, is
  57. reproduced below in full text form. I wish to thank Ron Zweig for
  58. having downloaded this program.
  59. See also modified version, MASTERNW.RN below]
  60.  
  61. When you run it, it starts by announcing "Begin Keystroke
  62. Capture." If you immediately hit the PrtSc key it aborts. Other-
  63. wise, it records every keystroke you enter onto a temporary
  64. phrase.
  65.  
  66. Once you have captured the keystrokes that you need, press PrtSc.
  67. The program hums and purrs for a moment, working in a hidden
  68. window (there must be a window available or it comes to a grind-
  69. ing halt before it even starts), where it creates a temporary
  70. program file, dumps the captured keystrokes into it, saves the
  71. file to disk, then prompts you to select the phrase key you wish
  72. to use. If you have made a mistake entering keystrokes, pressing
  73. PrtSc here quits the program. Otherwise, simply select the
  74. desired letter or number for the phrase. (I have added, with the
  75. help of my daughter Tamar, the ampersand key [&1-&0; &A-&Z]
  76. option, to make it possible to spare your actual phrase library.
  77. If you wish to use this option, just strike & then the desired
  78. letter/number. -- I.E-Z.)
  79.  
  80. At this point, you are asked if you wish to record the file to
  81. disk for permanent use. If you answer with an 'n', the temporary
  82. file created by the program is erased and the program ends. If
  83. you answer with a 'y', you are asked to supply a valid filename.
  84. You can use a full pathname if you desire, although you cannot
  85. specify a different drive. And the program will not allow you to
  86. overwrite an existing file, so the filename must be unique to the
  87. directory. If you change your mind about recording a program file
  88. to disk, press PrtSc to abort. Whether you record a file or not,
  89. your phrase is loaded and ready to roll!
  90.  
  91. I [i.e., Wallengren] use the program any time I'm faced with per-
  92. forming a series of repetitive actions. For instance, if I want
  93. to move the scene headings from a television script that I've
  94. written into a separate file, I simply move the cursor to the
  95. start of the document and begin the keystroke capture. Once that
  96. has started, I'll move to the command line, type se \EXT.\ (for
  97. outdoor scenes), F10 (to execute the search), Define (with F1 or
  98. whatever is relevant), Alt-F10 (to move to the other file), + (to
  99. copy the defined text), Alt-F10 (to return to the script file)
  100. and F2 (to undefine). Then I press PrtSc to terminate the
  101. capture. After that, I'm able to perform each
  102. search/define/move/undefine with just two keystrokes.
  103.  
  104. If you get a message on the prompt line saying "Aborted! Unable
  105. to create temp file," one of two very unlikely things has
  106. occurred. You are using all nine windows and one or more of them
  107. contains a directory listing or you have gone out of your way to
  108. name a file __zzyzx.p0m AND you have made it read-only (there may
  109. be other reasons for getting this error message but I haven't
  110. stumbled onto them yet). By the way, if you are one of the
  111. unfortunate few who has an important file named either
  112. __zzyzx.p0m, kiss it good-bye! These routines take great pleasure
  113. in erasing files with those names --
  114.  
  115. I run this utility on a 6-8-10MHz AT clone. It flies. There
  116. should be no speed problem with MASTERPM.RN on a standard PC. You
  117. should be able to speed thing up a little by deleting the comment
  118. lines in the routine. Each comment line is preceded by a semi-
  119. colon to distinguish it. (You'll save some memory doing this,
  120. too).
  121.  
  122. Comments or criticisms are always welcome!
  123. -- Ernie Wallengren
  124. (BIX and Genie: ewallengren
  125. Compuserve: 71360,2206
  126. [from within Bitnet: 71360.2206@compuserve.com]
  127. The Source: AAK732)
  128. ***********************************************
  129. Note:
  130. MASTERPM cannot record text you write with Nota Bene 3.0 MENUS.
  131. So always use command line options.
  132. There is also a problem with Nota Bene new 3.0 keyboard: if you
  133. use ESC as part of your normal operations while running MASTER-
  134. PM.RN (e.g., to undefine or close a footnote window), you stop
  135. the program, since ESC now also stops programs (instead of the
  136. older CA+Break, which still works, however). This can be cured in
  137. one of the following ways:
  138.  
  139. (1) Use F2 instead of ESC to undefine, and write "func xd" on
  140. command line to close a window. (You can also use the same
  141. command for "undefine" as well, instead of F2.)
  142. (2) Alternatively, customize a separate key for "XD": it will
  143. work for both "undefine" and "close window".
  144. (3) Alternatively, delete the "bk" code from the ESC definition
  145. in your keyboard. ESC will no longer stop programs, but would you
  146. suffer from going on using CA+Break? (If you would, you are after
  147. all free to customize a better keyboard combination.)
  148. ***********************************************
  149. MASTERNW.RN
  150. MASTERPM.RN was modified again October 28, 1989 with the help of
  151. an undocumented feature, reported by Jonathan Zuck
  152. (JZ_UFI@JHUVMS.BITNET). This feature is the command 'SAVE %phrase
  153. key number/letter' (1-9/A-Z). It writes to disk the contents of
  154. an indicated phrase. This has made it possible to eliminate the
  155. whole procedure of opening an alternative window, where the whole
  156. concatenated key-capture is written down, saved and then loaded
  157. on a key. The procedure is much simpler now: the concatenated
  158. phrase is saved on 0 when concatenation is terminated (with
  159. PrtSc, as before), then 'SAVE %0' creates a file called 0.SAV,
  160. which is loaded on the indicated key. It is renamed, if user
  161. wishes to use it a a future program under a different name, or
  162. discarded, if user does not need it.
  163.