home *** CD-ROM | disk | FTP | other *** search
/ Shareware Gold 1 / The_Golden_ROM_Series_-_Shareware_Gold_Volume_1_Number_11_-_SK_89-301_-_1989.iso / LIB017 / MACROS.HLP < prev    next >
Text File  |  1986-10-01  |  10KB  |  201 lines
  1.                                KEYSTROKE MACROS
  2.  
  3.     A Keystroke Macro is simply a collection of keystrokes which is saved
  4.     so you may issue one command and repeat the series of strokes again
  5.     and again.  In PC-TYPE+, Keystroke Macros can be a powerful tool to
  6.     help you with your editing tasks - they are a tremendous reformatting
  7.     tool.
  8.  
  9.     TO DEFINE A MACRO:
  10.        (1) Press AltY             -start-  ( Y will blink on Command Line)
  11.        (2) Enter your keystrokes  -define-
  12.        (3) Press AltY             -end-           ( Y will stop blinking )
  13.  
  14.     The Macros you define may be saved as a permanent feature of PC-TYPE+
  15.     if you find some which are particularly useful.  You may save up to 10
  16.     Macros in any one Defaults file.  There is an eleventh Macro which is
  17.     a temporary Macro - it is the one which is created by the process
  18.     above.
  19.                               Press the PgDn Key
  20.  
  21.     After you define the Macro with AltY, you may use it as often as you
  22.     wish until you define a new one or exit the current PC-TYPE+ session.
  23.     At that point you must save the temporary Macro to one of the 10 Macro
  24.     positions or it will be lost when the new Macro is defined.
  25.  
  26.     To make those Macros you save in the 10 Macro positions permanent, you
  27.     must either save an ALL Defaults file, or save ALL the defaults to
  28.     PC-TYPE+.  (See the HELP file DFLTS_SV).
  29.  
  30.                        Running the Temporary Macro (CtrlY)
  31.  
  32.     After defining the Macro as above, to run the Macro, just press CtrlY.
  33.     That's all.  Move the cursor to the asterisk below and press AltY.
  34.     (*)
  35.     Now type PC-TYPE+ and press AltY again.  The blinking Y should now
  36.     stop blinking.  Now press CtrlY 2 or 3 times.  You have now made and
  37.     run a PC-TYPE+ Keystroke Macro.  NOTE: Esc WILL CANCEL A MACRO BEING
  38.     DEFINED OR STOP A MACRO WHICH IS RUNNING.
  39.                               Press the PgDn Key
  40.  
  41.                          MAKING A MACRO WHICH REPEATS
  42.  
  43.     To make a Macro repeat, instead of ending the Macro definition with
  44.     AltY, you end it with CtrlY.  This tells PC-TYPE+ that when the MACRO
  45.     is finished, start it over again.  Such a MACRO will continue to run
  46.     until you press the Esc key or until a message is written to the
  47.     Message Line, (usually the message "At TOP or BOTTOM of file.").
  48.  
  49.     Follow these instructions carefully.  Move the cursor to the asterisk.
  50.     (*)
  51.  
  52.     Press AltY.  The warning prevents you from inadvertently wiping out
  53.     the last Macro you defined.  If you had saved it, you would not have
  54.     gotten the warning.  Press Y.  Now type PC-TYPE+ and then press the
  55.     left arrow 8 times until the cursor is on the "P" of "PC".  Press
  56.     CtrlY to end the Macro, and then press CtrlY again.  This will
  57.     continue to repeat until you press the Esc key.  Press Esc.
  58.  
  59.                               Press the PgDn Key
  60.  
  61.     The F10 key is a powerful adjunct to Keystroke Macros.  F10 will
  62.     execute the instruction on the Command Line (normally a Locate
  63.     instruction for Keystroke Macros) and leave the cursor in the text
  64.     area. ───────── (Follow the arrows in this example) ─────────────────┐
  65.                                                                          │
  66.     ┌──Press F10, type "abcd" and then press the "Del" key twice.  Now  │
  67.     │   press CtrlY to end the Macro definition.  Press CtrlY again and  │
  68.     │   let the Macro run its course.                                    │
  69.     │       ┌────────────────────────────────────────────────────────────┘
  70.     │ xxxxxx└─ Move the cursor to the Command Line and type the
  71.     │ xxxxxx    command: /xxxxxx  (Make sure there are 6 x's in your
  72.     │ xxxxxx    locate command.)  Now move the cursor to the asterisk
  73.     │ xxxxxx    and press AltY (and then Y again.)───────────────────────┐
  74.     └────────────────────────────────────────────────────────────────────┘
  75.     As you can see, the Macro stopped itself when the message was issued.
  76.     Most functions, except those requiring keystroke entries may be
  77.     included in your Macros.
  78.  
  79.                               Press the PgDn Key
  80.  
  81.                                CtrlK and MACROS
  82.  
  83.     It is often useful to be able to interrupt a Macro and key in a few
  84.     characters which may change from application to application.  This may
  85.     be accomplished with Ctrl K.
  86.  
  87.     While defining your Macro, when you come to a point where you want to
  88.     interrupt the Macro, press CtrlK.  The cursor shape will change to a
  89.     square a the TOP of the current cursor position.  You may then key in
  90.     the unique strokes.  To return to MACRO execution, press the Enter
  91.     key.
  92.  
  93.     The next time you call this Macro, when it reaches the CtrlK keystoke,
  94.     the cursor shape will again change, and the Macro will wait for your
  95.     new keyboard entry.  As soon as you press the Enter key, then the
  96.     Macro will resume operation with those keystrokes you entered after
  97.     pressing Enter the first time.
  98.  
  99.                               Press the PgDn Key
  100.  
  101.                                 CtrlK EXAMPLE
  102.  
  103.     (*)
  104.  
  105.     1.  Move the cursor to the asterisk above.
  106.     2.  Press AltY to begin a new Macro.  (Answer Y if the "Current Macro
  107.         will be lost" message appears).
  108.     3.  Type "abc" as the first three keystrokes of the new Macro.
  109.     4.  Press CtrlK.  (Notice the cursor has changed shape.)
  110.     5.  While in CtrlK mode, type "123".
  111.     6.  Exit CtrlK mode by pressing Enter.  (Notice the cursor shape now.)
  112.     7.  Type "def" as the last three keystrokes in the Macro.
  113.     8.  End the Macro by pressing AltY again.
  114.  
  115.     Now try the Macro by pressing CtrlY.   The Macro will type "abc" and
  116.     then wait for your CtrlK entry.  Type "XXXXXX" and then press Enter.
  117.     The Macro will now finish with "def".
  118.  
  119.                               Press the PgDn Key
  120.  
  121.                               A WORD OF CAUTION
  122.  
  123.     For maximum flexibility, when in the CtrlK mode of a Macro which is
  124.     currently running, you are allowed to press the "Esc" key to move back
  125.     and forth between the Command Line and the Text area.  In other words,
  126.     pressing "Esc" will not terminate the Macro execution in this case.
  127.  
  128.     If you make such a Macro repetitive, it might be difficult to stop.
  129.     The best way to exit such a Macro is to force a message to be written
  130.     to the Message Line which will cancel the Macro.
  131.  
  132.     This can be easily done by going to the Top of the file and pressing
  133.     the Up arrow (or going to the bottom of the file and pressing the Down
  134.     arrow) - any message will do.  Even the message "Are you sure?" which
  135.     is given when you press F4 or Ctrl Break will work.  Otherwise, you
  136.     must be quick enough to catch the Macro before the next CtrlK mode is
  137.     entered.
  138.  
  139.                               Press the PgDn Key
  140.  
  141.             MAKING YOUR TEMPORARY MACRO ONE OF THE 10 SAVED MACROS
  142.  
  143.     The Y on the Command Line tells you that you have a Temporary Macro
  144.     defined.  On the menu for the Miscellaneous functions, (F8), you will
  145.     see that F10 says "Save Macros".  Press F8, then F10, AND THEN Esc.
  146.     You saw the resident KEYSTROKE MACROS menu.
  147.  
  148.     To save your Temporary Macro, you would go to this KEYSTROKE MACROS
  149.     menu and then using the TAB key move the Macro Selection Bar to the
  150.     position you want and press F10.  At this point you may press Esc if
  151.     you change your mind or type in the mnemonic for your macro that would
  152.     be meaningful to you.  Then press the F10 key and your Macro will be
  153.     moved and the "Y" will disappear from the Command Line.  Try it.
  154.  
  155.     This Macro has only been moved - it has not been permanently saved.
  156.     You must save your defaults to disk file or make them permanent within
  157.     PC-TYPE+ or you will lose this macro when you exited PC-TYPE+.
  158.  
  159.                               Press the PgDn Key
  160.  
  161.                          RUNNING ONE OF THE 10 MACROS
  162.  
  163.     If you remember the position in which you saved each MACRO, you could
  164.     hold down the Ctrl key and then press the 1, 2, ... 9 or 0 key at the
  165.     TOP of your keyboard to run the MACRO.  If you're like me, you
  166.     probably need a quick reminder.
  167.  
  168.     We provided a few "seed" macros when we sent you your copy of
  169.     PC-TYPE+.  Let's try a couple.  Move the cursor to the asterisk on the
  170.     line below and then press F8, F9 and F1.  (*) This macro was defined
  171.     with the keystrokes
  172.                        AltU Ctrl~  AltL AltR 
  173.  
  174.     and is an enhancement to the standard Split Line function Ctrl~.
  175.     AltU was pressed first to insure that any previous marked area would
  176.     be cleared before marking a new area.  This is an important safeguard
  177.     when using any of the blocked area reformatting commands.  Now press
  178.     F8, then F9, and then F2.
  179.                               Press the PgDn Key
  180.  
  181.     The Join function was defined with the keystrokes
  182.  
  183.                            AltU AltL  AltL AltR 
  184.  
  185.     You may of course, replace any of these Macros with your own.  You may
  186.     also save multiple ALL Defaults files with different sets of Macros in
  187.     each and then call them in as needed for special functions.
  188.  
  189.     MACRO 3 which we provided enhances the CtrlM function which moves a
  190.     marked area of text at the cursor location by first splitting and then
  191.     moving.  MACRO three merely adds a CtrlR after the CtrlM so that the
  192.     target paragraph will be reformatted and made more recognizable.
  193.  
  194.     MACRO 4 will reformat all the paragraphs from the current cursor
  195.     position to the end of the file.
  196.  
  197.     Try these Macros and decide if you want to keep them or not.
  198.  
  199.                      Press F4 to Return to the HELP Menu
  200.  
  201.