HP 3000 Manuals

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


HP EDIT Reference Manual

Overwrite From Macro 

Purpose 

Enables you to overwrite text within an executing macro.

Default Syntax 

$o

where n is a count that represents the column where overwriting is to
begin.  The default value of n is the current column position.

Description 

This command, when executed within a macro, suspends a currently
executing macro and enables you to overwrite text.

Command Process 

When the macro pauses for your input, HP EDIT moves the cursor to the
position where you are to begin overwriting text.  When you have finished
overwriting 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 a substitute for the Meta
key.  Consequently, you should use the recommended syntax of $o within a
macro.

Procedure 

To execute this command within a macro: 

   1.  Construct the macro containing this command using proper macro
       syntax.  Refer to the Define Macro command for information about
       constructing macros.  Skip to Step 3 if this macro is preemptive
       (preempts the command to which the key is ordinarily assigned).

   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 / 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 
overwrite text: 

   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:

            mo=AOverwrite word/^mb$o; to change 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.  Press the m key.  HP EDIT displays the following prompt on the
       message line:

            Specify macroname

   6.  Press the o key.  HP EDIT executes the macro and waits for your
       input after the following text appears:

            Overwrite word

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

            Overwrite here_

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

            Overwrite here to change the text.

Related Commands 

       Append Line From Macro
       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
       Overwrite
       Replace Character From Macro
       Replace Line From Macro
       Replace Word From Macro



MPE/iX 5.0 Documentation