home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / wordperf / macade41.arj / OVERVIEW.DOC < prev    next >
Text File  |  1991-08-15  |  6KB  |  137 lines
  1.  
  2.                  MacroAde (TM)
  3.               Utilities for WordPerfect 5.1 Macros
  4.  
  5.                                   Version 4.1
  6.  
  7.  
  8.                   A Product of
  9.                Performance Sciences International
  10.                 Summerfield, NC
  11.  
  12.           Copyright (c) 1991 by Jeffrey S. Kane, Ph.D.
  13.  
  14.  
  15.                 AN OVERVIEW OF MacroAde
  16.  
  17.      MacroAde is a small but (in our view) highly useful collection
  18. of utilities and macros for proficient users of WordPerfect 5.1. 
  19. The items contained in this package are listed below along with
  20. brief descriptions of each.
  21.  
  22.      Utilities:
  23.  
  24.           The following utilities give users the ability to apply
  25.      the full power of their stand-alone text editors (e.g., QEDIT,
  26.      MultiEdit, VEDIT, Norton Editor) to the creation and
  27.      modification of macros, thereby circumventing the very
  28.      primitive macro editing capability within WordPerfect.  In addition,
  29.      TildeChk will enable you to quickly find and correct the MOST COMMON
  30.      macro programming errors: missing tildes.
  31.  
  32.      1.   MACROLST.exe:   translates WordPerfect 5.1 macro (.wpm)
  33.                           files into corresponding ASCII text files
  34.                           with .LST extensions;
  35.  
  36.      2.   MCOMPILE.exe:   compiles macro source files in ASCII text
  37.                           form into .wpm files executable as macros
  38.               within WordPerfect 5.1;
  39.  
  40.      3.   COMMANDS.ref:   an ASCII text listing of keystroke and
  41.                           macro commands used in WordPerfect 5.1. 
  42.                           It also contains all of the information
  43.                           on the numeric codes for each keystroke
  44.                           command contained in the recently
  45.                           released Appendix T.  This file can be
  46.                           displayed as a second window in any
  47.                           multiwindow editor for reference purposes
  48.               during macro editing; and
  49.  
  50.      4.   TildeChk.exe:   Checks for missing tildes (~) in macro source
  51.               files conforming to the format used by the
  52.               MacroLst decompiler (above).    Produces a listing
  53.               of the line numbers and initial macro commands of
  54.               the sequences in which tildes are missing; reports
  55.               this information for the first 20 tilde omissions
  56.               found.  Missing tildes are the MOST COMMON macro
  57.               programming error.  TildeChk will save you hours
  58.               of time!
  59.  
  60. Macros:
  61.  
  62.      Four unrelated categories of macros are provided in this
  63. package.  The macros in each of the categories are briefly
  64. described below:
  65.  
  66.      1.   Editor Control Macros:
  67.            Each of these macros work in conjunction with a
  68.       batch file, MacroLst, and MCompile to enable you to
  69.       use either any external editor of your choice or
  70.       WordPerfect itself to edit macros.
  71.  
  72.       A.  EDITM.wpm:
  73.             Enables you to use any external editor of your
  74.           choice to edit a macro within a DOS shell and then
  75.           return back to the place you left from in WordPerfect.
  76.           It automatically recompiles the modified macro so it
  77.           is available for use upon your return to WordPerfect.
  78.  
  79.       B.  EDITWP.wpm:
  80.             Converts macros to WordPerfect documents and
  81.           brings them up on the full WordPerfect document screen
  82.           for editing; pressing EXIT causes the edited macro
  83.           to be recompiled, ready for use.
  84.  
  85.      2.   Macro Menu Macros:
  86.                As you utilize the power of macros to a
  87.           progressively greater extent, you inevitably reach the
  88.           point where you can't remember the names and functions of
  89.           all the macros you've defined.  The following macros
  90.           solve this problem by providing the capability to display
  91.           lists of your macros, with descriptions, and to execute
  92.           any one of them by highlighting it and pressing a
  93.           specified key.
  94.  
  95.       A.  ALTM.wpm:
  96.             A relatively simple macro menuing system that
  97.           uses the list files feature of WordPerfect.
  98.  
  99.       B.  ALTL.wpm:
  100.             A much more sophisticated macromenuing system
  101.           allowing the use of multiple customizable menu
  102.           files and the display of macro names and their
  103.           descriptions on the same screen.    The items in a
  104.           macro menu may be modified or deleted right from
  105.           within the macro menu itself.
  106.  
  107.       C.  MOVECSR.wpm:
  108.             Not a macro menu but a useful adjunct to those
  109.           above.  This macro directs you to move the cursor
  110.           to the place in your document where you want the
  111.           macro you've selected to actually execute.  The
  112.           command to execute this macro is placed at the very
  113.           top of any macro for which you want to be sure the
  114.           cursor is positioned correctly.
  115.  
  116.      3.   BRINGBAK.wpm:  
  117.                A really unique macro that works in combination with
  118.       either of two .exe files to allow you to communicate
  119.           information from an outside program (accessed via SHELL)
  120.           back into WordPerfect.  This capability creates many
  121.           interesting possibilities for shelling out to DOS,
  122.           generating data files via another program or using
  123.           external programs to locate files, and returning to
  124.           WordPerfect with the information that could allow the new
  125.           or located files to be imported.
  126.  
  127.      4.   "On Beyond Z" with ALTZ.wpm:
  128.            Have you run out of letters to use with ALT-invoked macros
  129.       yet?    I had, so I wrote an embarrassingly simple macro which
  130.       allows the use of ALT Z plus any one of up to 54 other characters
  131.       that can be entered from the keyboard that are legal in file
  132.       names.  Undoubtedly, many others have come up with the same
  133.       macro, but if its availability here helps a few more people,
  134.       it's worth the redundancy.
  135.  
  136.  
  137.