Contents - Index


 

Use EditAppend to append a specified text string to session text within a specified column range for a specified group of lines.  The string is inserted immediately after the last non-blank character within the specified column range.

 

EditAppend may also be entered as EditApp+[end] or App[end].

 

The group of lines can be specified by pre-selecting the lines (see Selection) or by using the FCT operand.  If neither a pre-selection or FCT operand is provided, the group of lines consists solely of the current line.

 

Required Operands

 

STR is the text string to be appended.  STR may be up to 256 characters in length.

 

Optional Operands

 

FCT specifies the number of lines for which text is to be appended.  If FCT is specified as an asterisk (*), text will be appended for all lines through the end of the session.

 

 Default: 1.

 

ZONE is the column range in which to append text. Enter it in the format xxx-yyy where xxx and yyy are numbers between 1 and the session maximum line width.  For example, ZONE=11-20 signifies columns 11 to 20.  ZONE=5 is the same as ZONE=5-5, ZONE=5-* specifies columns 5 through the session maximum line width, and ZONE=-5 is the same as ZONE=1-5.

 

 Default: current session zone.

 

Return Codes

 

OK Successful.

 

Examples

 

Append a semicolon to each of the lines currently selected:

 

   => app ';'