home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / wp4 / mcroade3.lzh / ALTL.DOC next >
Text File  |  1991-06-14  |  11KB  |  233 lines
  1.                              ALTL.wpm
  2.             A Macro Menuing System for WordPerfect 5.1 
  3.  
  4.                                 by
  5.  
  6.                       Jeffrey S. Kane, Ph.D.
  7.                 Performance Sciences International
  8.                           Summerfield, NC
  9.  
  10.  
  11. 1.   Read the MacroAde.doc and Disclaim.er files distributed with this
  12.      macro.
  13.  
  14. 2.   Requires:
  15.           WordPerfect 5.1
  16.  
  17. 3.   Features:
  18.  
  19.      A.   Each menu can list the names and descriptions of 40
  20.           macros.
  21.  
  22.      B.   Names and descriptions listed side-by-side; no additional
  23.           strokes to get descriptions.
  24.  
  25.      C.   Expanded macro descriptions (64 versus 39 characters)
  26.           which are instantly editable.
  27.  
  28.      D.   Any macro in a menu can be executed from the menu by
  29.           scrolling the highlight bar down to its name and pressing
  30.           [ENTER].
  31.  
  32.      E.   Any macro in a menu can be deleted from the menu.
  33.  
  34.      F.   A new macro name and description can be entered on any of
  35.           the menu's 40 lines.
  36.  
  37.      G.   Duplicating AltL.wpm under different names, making
  38.           corresponding changes to fresh and renamed copies of the
  39.           TableX.wpm and Macromnu.X files, and reflecting those
  40.           changes in the header portion of the renamed AltL.wpm
  41.           copies, allows the creation and use of specialized macro
  42.           menus.  For example, you might create a menu of all the
  43.           macros you use in producing a newsletter, another for
  44.           those in preparing annual reports, another for those used
  45.           in preparing articles in a particular format required by
  46.           a journal, etc.
  47.  
  48. 4.   Installation:
  49.  
  50.      A.   AltL.wpm requires the following files to be present in
  51.           the directory in which your macros reside:
  52.                      AltL.wpm
  53.                      Table1.wpm
  54.                      Macromnu.1
  55.              Modtable.exe   (users don't use this file
  56.                     directly but it must be present
  57.                                     for AltL.wpm to work properly)
  58.  
  59.       Be sure to keep copies of the original unused versions of
  60.           these files in case you want to set up additional menus
  61.           or in the event you have to re-install AltL.
  62.  
  63.      B.   The highlight bar in the AltL menu utilizes the color
  64.           attributes assigned to the UNDERLINE feature.  If you
  65.           don't feel that the representation of UNDERLINE is set to
  66.           allow highlighted menu items to stand out sufficiently,
  67.           change the color attributes assigned to UNDERLINE by
  68.           accessing Setup--Display--Colors/Fonts/Attributes--Screen
  69.           Colors (Shift-F1  2  1  1) in WordPerfect.
  70.  
  71.      C.   Edit the AltL.wpm file in the macro editor (Ctrl-F10 
  72.           AltL  2).  Change the header information according to
  73.           the instruction comments at the top of the file. 
  74.           Specifically,...
  75.                1)    Change the directory assigned to WPMDir to the
  76.                      one holding the WordPerfect macro files in
  77.                      your system if 'D:\WP51\' is not correct.
  78.                2)    Change the name of the file assigned to
  79.                      MacroFil if you do not wish to use the name
  80.                      "Macromnu.1" for this purpose.  (Be sure to
  81.                      change the file's name also in this case.)
  82.                3)    Change the name of the file assigned to
  83.                      MacTable if you do not wish to use the name
  84.                      "Table1.wpm" for this purpose.  (Be sure to
  85.                      change the file's name also in this case.)
  86.                4)    Change the value assigned to OldSpeed from
  87.                      "Normal" to one of the other values specified
  88.                      in the comment if you wish the macro to
  89.                      restore the keyboard to some cps speed besides
  90.                      "Normal" at the conclusion of the macro.
  91.                5)    Do NOT change the values assigned to any other
  92.                      variables.
  93.  
  94.      D.   Enter WordPerfect and retrieve the Macromnu.1 file.  At
  95.           the top of the document activate Reveal Codes (Alt-F3)
  96.           and notice that the font selected is *Courier 10 cpi. 
  97.           This is a fixed space font within the basic HPLaserJet
  98.           Series II font list.  It should work okay regardless of
  99.           whether you're using this printer or not since this file
  100.           is used only for display purposes, and not meant to be
  101.           printed out.  However, if some problem arises (e.g.,
  102.           lines not all the same length, or some lines wrapping to
  103.           second line), or if you wish to print the file out,
  104.           change the printer selection to one available on your
  105.           system and be sure a 12 point (10 cpi) fixed space font
  106.           is selected as the base font (Ctrl-F4  4).
  107.  
  108.      E.   Upon your initial execution of AltL (accomplished by
  109.           merely holding down the ALT key and pressing L, of
  110.           course), you see that all the menu entries are specified
  111.           as "*Not in Use".  You can now add any of your macros by
  112.           merely scrolling to the line on which you want the entry
  113.           for a macro to appear and pressing the [INSERT] key.  You
  114.           will then be prompted for the macro's name and
  115.           description.  Pressing [ENTER] after typing in the
  116.           description (you can leave the description blank if you
  117.           so wish) sends the system into a brief spasm while the
  118.           .wpm are externally altered and you are then returned to
  119.           the now revised menu.
  120.  
  121. 5.   Operation:
  122.  
  123.      A.   Add or modify any macro entries in the menu by repeating
  124.           the procedure described in 4D above for the initial
  125.           insertion of macro entries.
  126.  
  127.      B.   Delete macro entries from the menu by moving the
  128.           highlight bar down to the target entry and pressing the
  129.           [DELETE] key.  You'll be prompted with "Are you
  130.           sure...(Y/N)?" and the deletion will then proceed or be
  131.           canceled depending on your response.
  132.  
  133.      C.   Most Importantly, you can execute a macro by moving the
  134.           highlight bar to its menu entry and pressing [ENTER]. 
  135.           The macro will execute at the place in your document from
  136.           which you invoked the macro menu unless you have added
  137.           the {NEST}MOVECSR~ macro command as the first line of the
  138.           macro to be executed.  This command invokes the
  139.       MOVECSR.wpm macro, also supplied as part of the MacroAde
  140.           package, which allows you to move the cursor anywhere in
  141.           your document before the macro of primary interest is
  142.           executed.
  143.  
  144.      D.   You'll note that the movement of the highlight bar via
  145.           the up and down cursor keys is rather slow.  This was
  146.           unavoidable because the WordPerfect program apparently
  147.           does not clear the keyboard buffer between keyboard
  148.           entries occurring within macros.  Consequently, a
  149.           keyboard buffer clearing routines written in the macro
  150.           language had to be added to prevent the scroll bar from
  151.           running out of synchronization with the macro's line
  152.           counter.  A side effect of the buffer clearing routine is
  153.           to slow down the highlight bar section.  This can be
  154.           partially compensated for by using the PgUp and PgDn
  155.           keys, which actually just move you one screen (24 lines)
  156.           at a time, but quickly.
  157.  
  158.      E.   The program strives, and to the best of my knowledge
  159.           succeeds, at returning your system in the same state it
  160.           was in when AltL was invoked.  It also will return you to
  161.           the place in your document at which it was invoked unless
  162.           you use MOVECSR.wpm.  Note that in some cases, due to the
  163.           continuing quirks of WordPerfect, the line to which it
  164.           returns, or the following one, may be knocked slightly
  165.           out of format.  This happens infrequently and the
  166.           readjustment of the line is always just a matter of 1 or
  167.           2 keystrokes.
  168.  
  169. 6.   Setting Up Additional Menus:
  170.  
  171.           You can set up as many different AltL-type menus as you
  172.      wish.  Each such menu would be invoked by a different name,
  173.      preferably by an ALT plus letter combination for ease of
  174.      execution.  Here is the procedure for setting up each such
  175.      additional menu.
  176.  
  177.      A.   Decide on the names you want to assign to the main
  178.           menuing macro (AltL.wpm) in the new menu to be set up. 
  179.           Also decide on the numbers to be used in the new names
  180.           for Table1.wpm and Macromnu.1 that will be used in the
  181.           new menu.  I recommend just using the next unused number.
  182.  
  183.      B.   Copy fresh copies of the following files from your
  184.           archive disk or directory to the new names you have
  185.           selected in the directory where your macros reside.  BE
  186.           ABSOLUTELY CERTAIN TO COPY THE FILES TO THEIR SPECIFIC
  187.           NEW NAMES OR ELSE YOU WILL OVERWRITE THE VERSIONS YOU'VE
  188.           PREVIOUSLY SET UP.
  189.  
  190.            Copy  AltL.wpm  D:\WP51\NewAltName.wpm
  191.            Copy  Table1.wpm  D:\WP51\Table#.wpm
  192.            Copy  Macromnu.1  D:\WP51\Macromnu.#
  193.  
  194.      C.   Edit the new Alt?.wpm (formerly AltL.wpm) file in the
  195.           macro editor (Ctrl-F10  Alt?  2).  Change the header
  196.           information according to the instruction comments at the
  197.           top of the file.
  198.                1)    Change the directory assigned to WPMDir to the
  199.                      one holding the WordPerfect macro files in
  200.                      your system if "D:\WP51\" is not correct.
  201.                2)    Change the name of the file assigned MacroFil
  202.                      to the new file name you've assigned to
  203.                      Macromnu.1 in Step A, above (i.e., to
  204.                      Macromnu.?, where ?=the new total number of
  205.                      menus you'll have).
  206.                3)    Change the name of the file assigned to
  207.                      MacTable to the new file name you've assigned
  208.                      to Table1.wpm in Step A, above (i.e., to
  209.                      Table?.wpm, where ?=the new total number of
  210.                      menus you'll have).
  211.                4)    Change the value assigned to OldSpeed from
  212.                      "Normal" to one of the other values expressing
  213.                      the cps level at which you run your keyboard
  214.                      outside of this menuing system.
  215.  
  216.      D.   With these steps accomplished you are now ready to invoke
  217.           the new menu and insert the entries you want it to
  218.           contain, as described previously in the installation
  219.           section.
  220.  
  221. 7.   Technical support:
  222.  
  223.       Free technical support will be furnished to any licensed users
  224.      who calls on weekdays during the hours from 9:00 a.m. to 5:00 p.m.
  225.      (Eastern) at the following number:  (919) 643-3492
  226.  
  227.      We may also be reached by mail at:
  228.  
  229.      Performance Sciences International
  230.      Suite 1250
  231.      3001 Latta Drive
  232.      Summerfield, NC  27358
  233.