HP 3000 Manuals

Append Line From Macro [ HP EDIT Reference Manual ] MPE/iX 5.0 Documentation


HP EDIT Reference Manual

Append Line From Macro 

Purpose 

Enables you to add a new line within an executing macro.

Default Syntax 

$A

Description 

This command, when executed within a macro, suspends the macro and
enables you to add a new line following the current line.

Command Process 

When the macro pauses for your input, HP EDIT moves the cursor to the
first column of a new line below the current line, enabling you to add
text.  You can add subsequent lines by pressing Return without preceding
it with the / key.  When you have finished adding text, pressing / and
Return returns you to Command mode.  After you have returned to Command
mode, HP EDIT resumes execution of the macro.

Syntax Considerations 

In order to use this command within a macro, you must properly construct
the macro using correct syntax.  Refer to the Define Macro command for
information about required syntax.

Since the standard Meta key (ESC) is displayed as ^[ when inserted in a
macro, HP EDIT provides the dollar sign ($) as an alternate Meta key.
Consequently, you should use the recommended syntax of $A within a macro.

Procedure 

To execute this command within a macro: 

   1.  Construct the macro containing the command using proper macro
       syntax.  Refer to the Define Macro command for information about
       constructing macros.  If the macro is preemptive, skip to Step 3.

   2.  Execute the macro by pressing the m key.  HP EDIT displays Specify 
       macroname on the message line.

   3.  Type the macro name, which can be a single key or key sequence.
       HP EDIT executes the macro and pauses for your input.

   4.  Provide the input and then press / and Return to return to Command
       mode.  HP EDIT resumes execution of the macro.

Example 

To construct, define, and execute a macro that pauses for you to add a 
new line below the current line: 

   1.  Insert a new line in text by executing the Insert Line (I)
       command.

   2.  Type in the following macro beginning at the cursor position:

            mL=AAppend a line/^m$AAto complete the text./^m

   3.  Press / and Return to exit Text Entry mode and enter Command mode.

   4.  Execute the Define Macro (z) command.  HP EDIT removes the macro
       from the screen and stores it for subsequent execution.

   5.  Issue the Execute Macro (m) command.  HP EDIT displays the
       following prompt on the message line:

            Specify macroname

   6.  Press the L key.  HP EDIT executes the macro and waits for your
       input after the following text is displayed on your terminal:

            Append a line
            _

   7.  Type starting here beginning at the cursor position as shown:

            Append a line
            starting here_

   8.  Press / and Return to return to Command mode.  HP EDIT resumes and
       concludes the macro execution and appends to complete the text. 
       following your input as shown:

            Append a line
            starting here
            to complete the text.

Related Commands 

       Append Line
       Append To Character From Macro
       Append To End Of Line From Macro
       Append To Word From Macro
       Define Replace Pattern From Macro
       Define Search Pattern From Macro
       Insert Character From Macro
       Insert Line From Macro
       Replace Character From Macro
       Replace Line From Macro
       Replace Word From Macro
       Overwrite From Macro



MPE/iX 5.0 Documentation