TSPLIT—Text Split a Line

The TSPLIT macro command moves part or all of a line of text to the following line. This makes it easier for you to add new material to existing text.

Syntax


Macro command syntax

>>-ISREDIT--TSPLIT--+------------------+-----------------------><
                    '-+-linenum-+--col-'   
                      '-label---'

linenum: A relative line number identifying the line where the split is to occur.
label: A label identifying the line where the split is to occur.
col: Specifies the column at which the text is to be split.

If you omit both operands, the split point is assumed to be the current cursor position.

Description

The TSPLIT macro command is affected by the current setting of the boundaries. For instance, data beyond the right boundary is not moved to the line added by TSPLIT. Data between the split column and the right boundary is moved to a new line. The cursor position is set to the split point.

To rejoin lines, use the TFLOW macro command. See TFLOW—Text Flow a Paragraph for more information.

For more information about splitting lines and other word processing commands, see Word processing and Splitting lines.

Return codes

0: Normal completion
12: Invalid line number
20: Severe error

Examples

To split the line labeled .TOP at column 15:

ISREDIT (LINENBR) = LINENUM .TOP
ISREDIT TSPLIT &LINENBR 15