home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / wordperf / macade41.arj / EDITM.DOC < prev    next >
Text File  |  1991-08-15  |  6KB  |  130 lines
  1.                              EditM.wpm
  2.                 Enables Use of External Text Editor
  3.             for Editing Macros from Within WordPerfect
  4.  
  5.                                 by
  6.  
  7.                       Jeffrey S. Kane, Ph.D.
  8.                 Performance Sciences International
  9.                           Summerfield, NC
  10.  
  11. 1.   Read the REGISTER.doc, LICENSE.doc, and WARRANTY.doc files distributed
  12.      with this macro.
  13.  
  14. 2.   Requires:
  15.      
  16.      A.   WordPerfect 5.1
  17.  
  18.      B.   The presence of the following files in the directory
  19.           where your WordPerfect macro files reside:
  20.  
  21.           1)   EditMac.bat
  22.           2)   Macrolst.exe
  23.           3)   MCompile.exe
  24.           4)   TildeChk.exe
  25. 3.   Features:
  26.  
  27.      A.   Enables the user to utilize his/her favorite external
  28.           text editor (e.g., QEDIT, MultiEdit, VEDIT, Norton
  29.           Editor,...Edlin?) to edit any macro while staying within
  30.           a keystroke of returning to the place in a WordPerfect
  31.           document from which the macro editing originated.
  32.      
  33.      B.   The edited macro is recompiled and ready for use as soon
  34.           as the user returns to WordPerfect from the editing
  35.           session.
  36.  
  37.      C.   In short, allows the user to gain the advantage of all
  38.           the power and familiarity of his/her text editor to edit
  39.           macros without any sacrifice in convenience.
  40.  
  41. 4.   Installation:
  42.  
  43.      A.   Copy the following files to the directory in which your
  44.           WordPerfect macros are located:
  45.  
  46.           1)   EditM.wpm
  47.           2)   EditMac.bat
  48.           3)   Macrolst.exe
  49.           4)   MCompile.exe
  50.           5)   Commands.ref
  51.           6)   TildeChk.exe
  52.  
  53.      B.   If your macro files are NOT located in 'D:\WP51\', then
  54.           edit the EditM.wpm macro using WordPerfect's macro editor
  55.           (Ctrl-F10  EditM  2).  Change the value assigned to the
  56.           "WPMDir" variable in the header section to the directory
  57.           in which your macro files are located.  Be sure to put
  58.           the closing "\" at the end of any other directory you
  59.           enter.
  60.  
  61.      C.   At the DOS command line change to the directory in which
  62.           your macro files are located.  Use your text editor to
  63.           edit the file, EditMac.bat.  When you bring this short
  64.           batch file up on your editor's screen you'll see a
  65.           comment section that instructs you to change the next
  66.           command line to reflect the command needed to start your
  67.           editor on the file designated by the batch parameters
  68.           %2%1.LST.  Follow these instructions precisely and then
  69.           save the file.
  70.  
  71.      D.   With the completion of the above steps, installation is
  72.           finished.
  73.  
  74. 5.   Operation:
  75.  
  76.      To edit a macro with your external text editor without leaving
  77.      WordPerfect, simply run the EditM macro (ALT-F10  EditM 
  78.      [ENTER]).  You will then be prompted to enter the name of the
  79.      macro you wish to edit.  You need only enter the name without
  80.      the .wpm (although the .wpm extension will be accepted).  The
  81.      macro will then shell to DOS where the batch file will take
  82.      over.  An ASCII text version of the macro will be created by
  83.      MACROLST and you will be placed in an editing session on that
  84.      file using your text editor.  Make any changes that you wish
  85.      to make to the macro.  For assistance in the syntax of macro
  86.      and keystroke commands, bring up the Commands.ref file in a
  87.      separate window in your editor.  It contains all of the
  88.      commands as well as the number codes for the keystroke
  89.      commands.  When you're finished, save the macro file and exit
  90.      the editor.  The compiler will take over at that point and
  91.      recompile the macro.  You'll then be returned to your
  92.      WordPerfect document at the place whence you began the macro
  93.      editing.
  94.  
  95.           Note that if either an illegal macro name is specified
  96.      or an error occurs during the attempt to recompile the edited
  97.      macro, the errors are caught and their correction is required
  98.      before the process can proceed further.  In the case of
  99.      specifying  an illegal macro name, the user is alerted to the
  100.      fact and returned to WordPerfect where he/she can try again.
  101.  
  102.           If the macro name you specify is legal but no such macro
  103.      by that name can be found, it will be assumed that you want
  104.      to create a NEW macro by that name.  A source file for such
  105.      a macro will be created and brought up into your editor with
  106.      the macro name and header elements already entered.
  107.  
  108.         If an error occurs during compilation, the user is returned
  109.      into his/her editor to correct the problem.  If for some reason
  110.      you don't want to be returned to the editor (e.g., you've tried
  111.      to fix the problem numerous times with no success), just press
  112.      Ctrl-BREAK at the point where you're told to press any key and
  113.      respond with 'Y' to the prompt 'Cancel Batch Job (Y/N)?'.  This
  114.      will cause the original version of the .wpm macro file to be
  115.      restored and you'll be returned to WordPerfect at the place from
  116.      which you started the attempt to edit the macro.
  117.  
  118. 6.   Technical support:
  119.  
  120.      Free technical support will be furnished to any licensed user
  121.      who calls on weekdays during the hours from 9:00 a.m. to 5:00 p.m.
  122.      (Eastern) at the following number:  (919) 643-3492
  123.  
  124.      We may also be reached by mail at:
  125.  
  126.      Performance Sciences International
  127.      Suite 1250
  128.      3001 Latta Drive
  129.      Summerfield, NC  27358
  130.