home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / wordperf / macade41.arj / EDITWP.DOC < prev    next >
Text File  |  1991-08-15  |  6KB  |  145 lines
  1.                   EditWP.wpm
  2.            Converts Macros to WordPerfect Documents,
  3.          Brings them into WordPerfect for Editing, and
  4.                Recompiles them to Macros
  5.  
  6.                                 by
  7.  
  8.                       Jeffrey S. Kane, Ph.D.
  9.                 Performance Sciences International
  10.                           Summerfield, NC
  11.  
  12. 1.   Read the REGISTER.doc, LICENSE.doc, and WARRANTY.doc files distributed
  13.      with this macro.
  14.  
  15. 2.   Requires:
  16.      
  17.      A.   WordPerfect 5.1
  18.  
  19.      B.   The presence of the following files in the directory where
  20.       your WordPerfect macro files reside (in addition to EditWP.wpm):
  21.  
  22.       1)   EditWPM.bat
  23.           2)   Macrolst.exe
  24.           3)   MCompile.exe
  25.           4)   TildeChk.exe
  26. 3.   Features:
  27.  
  28.      A.   Enables the user to utilize WordPerfect as an editor
  29.       to create and modify macros.
  30.      
  31.      B.   The edited macro is recompiled and ready for use as soon
  32.       as the user exits from the document version of the macro.
  33.  
  34.      C.   Syntax and tilde error checking with return (at user's
  35.           option) to the editing of the macro within WordPerfect
  36.           in the event that an error is found.
  37.  
  38.      D.   In short, allows the user to gain the advantage of all
  39.       the power and familiarity of WordPerfect in the editing of
  40.           macros without any sacrifice in convenience.
  41.  
  42. 4.   Installation:
  43.  
  44.      A.   Copy the following files to the directory in which your
  45.           WordPerfect macros are located:
  46.  
  47.       1)   EditWP.wpm
  48.       2)   EditWPM.bat
  49.           3)   Macrolst.exe
  50.           4)   MCompile.exe
  51.       5)   Commands.ref
  52.       6)   BoldCmds.wpm
  53.           7)   TildeChk.exe
  54.  
  55.      B.   If your macro files are NOT located in 'D:\WP51\', then
  56.       edit the EditWP.wpm macro using WordPerfect's macro editor
  57.           (Ctrl-F10  EditM  2).  Change the value assigned to the
  58.           "WPMDir" variable in the header section to the directory
  59.           in which your macro files are located.  Be sure to put
  60.           the closing "\" at the end of any other directory you
  61.           enter.
  62.  
  63.      D.   That's all there is to it!
  64.  
  65. 5.   Operation:
  66.  
  67.      A.      To edit a macro using WordPerfect as your text editor,
  68.     simply run the EditWP macro (ALT-F10  EditWP  [ENTER]).
  69.     You will then be prompted to enter the name of the macro you
  70.     wish to edit.  You need only enter the name without the .wpm
  71.     (although the .wpm extension will be accepted).  If the name
  72.         of the macro is blank or otherwise illegal, the user is alerted
  73.         to the fact and returned to WordPerfect where he/she can try
  74.         again.
  75.  
  76.      B.      If a macro with the (legal) name that you specify cannot
  77.         be found, the program assumes that you want to create a NEW
  78.         macro by that name and proceeds to place you in a blank macro
  79.         source code document, with the name you specified already filled
  80.         in.  You may then proceed to enter any macro program you wish
  81.         using all the features of WordPerfect.
  82.  
  83.      C.      If the macro you specified does exist, EditWP will then
  84.         shell to DOS where the batch file will take over.  An ASCII
  85.         text version of the macro will be created by MACROLST and this
  86.         will be imported into WordPerfect.  In a few moments you'll be
  87.         facing your macro on the full document editing screen of
  88.         WordPerfect.  Make any changes that you wish to make to the
  89.     macro.
  90.  
  91.      D.      For assistance in the syntax of macro and keystroke
  92.     commands, split the screen into two windows, switch to the DOC 2
  93.     window, and retrieve (using Text In/Out the first time) the
  94.     Commands.ref file.  It contains all of the commands as well as
  95.     the number codes for the keystroke commands.
  96.  
  97.      E.      When you're finished editing, press EXIT (F7).  The
  98.         compiler will take over at that point and (re)compile the macro.
  99.  
  100.      F. All editing of the macro in WordPerfect is done in Document 2
  101.         (as of Version 4.01 of MacroAde).  Therefore, make sure that
  102.         you don't have a document you're working on in the Doc 2 area
  103.         when you use EDITWP, or it will be overlaid by the macro.
  104.         If compilation is successful, you'll then be returned
  105.         to Document 1 in WordPerfect at whatever point in the document
  106.         you were located when you invoked EDITWP.
  107.  
  108.      G.      If an error occurs during the attempt to (re)compile the
  109.     edited macro, its correction is required before the process can
  110.     proceed further.  The user is returned into WordPerfect to correct
  111.     the problem. If for some reason you don't want to resume editing
  112.     the macro in WordPerfect (e.g., you've tried to fix the problem
  113.     numerous times with no success), just press Ctrl-BREAK at the
  114.     point where you're told to press any key and respond with 'Y'
  115.     to the prompt 'Cancel Batch Job (Y/N)?'.  This will cause the
  116.     original version of the .wpm macro file to be restored and you'll
  117.     be returned to WordPerfect at the top of a blank document screen.
  118.  
  119.      H.      Using BOLDCMDS.wpm: This little utility macro BOLDS all of the
  120.     macro and keystroke commands in a macro.  It is provided for those
  121.     who want to retain the precise look of WordPerfect's internal
  122.     macro editor in the WordPerfect document versions of their macros.
  123.     There are at least two reasonable motives for this: the macro and
  124.     keystroke commands are much easier to pick out when they are bolded,
  125.     and the printed appearance of a macro listing is much more attractive
  126.     and easier to read when the commands are bolded.  All that is
  127.     necessary to run this macro is to invoke it after the macro that is
  128.         to be edited has been brought into WordPerfect by EDITWP.  Of course,
  129.     it will also work fine if the macro has been saved and retrieved as
  130.     a WordPerfect document.
  131.  
  132.  
  133. 6.   Technical support:
  134.  
  135.      Free technical support will be furnished to any licensed user
  136.      who calls on weekdays during the hours from 9:00 a.m. to 5:00 p.m.
  137.      (Eastern) at the following number:  (919) 643-3492
  138.  
  139.      We may also be reached by mail at:
  140.  
  141.      Performance Sciences International
  142.      Suite 1250
  143.      3001 Latta Drive
  144.      Summerfield, NC  27358
  145.