HP 3000 Manuals

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


HP EDIT Reference Manual

Append To End Of Line From Macro 

Purpose 

Enables you to add text to the end of a line within an executing macro.

Default Syntax 

$;

Description 

This command, when executed within a macro, suspends a currently
executing macro and enables you to add text starting at the end of the
current line.

Command Process 

When the macro pauses for your input, HP EDIT moves the cursor one column
beyond the last character of the current line, enabling you to add
unlimited text.  You can add subsequent lines by pressing Return without
preceding it with the / key.  When you have finished adding text, press / 
and Return to return to Command mode.  HP EDIT then 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 $; 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 as specified in the macro.  HP EDIT executes
       the macro and pauses for your input.

   4.  Provide the input and then press the / and Return keys 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 append 
text to the end of a 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:

            m;=AAppend to/^m$;; to add 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 ; key.  HP EDIT executes the macro and waits for your
       input after the following text is displayed on your terminal:

            Append to_

   7.  Press the Space bar and type end of line as shown:

            Append to end of line_

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

          Append to end of line to add text._

Related Commands 

       Append Line From Macro
       Append To Character From Macro
       Append To End Of Line
       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