FILL

FILL aligns text to left and right margins. The FILL process is the same for buffers and ranges, and operates as follows:

1) Removes all leading spaces on every line.

2) Pads with spaces to the left margin.

3) Fills the line to the right margin.

4) Splits lines that are too long.

FILL will not allow any text to extend past the right margin and justifies only on the left margin. When FILL has completed, the current editing position will be at the end of the text filled.

The second argument is a string data type which is used to define additional word separation characters.

The third and fourth arguments are integer data types which provide for setting the buffer's left and right margins respectively. The defaults for the third and fourth arguments are the current left and right margin settings, respectively. The last argument holds an integer value, positive or negative, to determine the number of characters to indent the first line. The default is 0.

Syntax:

FILL ({buffer | range} [, string [, integer [, integer [, integer]]]])

Examples:

Align any text in the current buffer to the right and left margins.

FILL (CURRENT_BUFFER);

Fill the current buffer using a left margin of 10, right margin of 70, paragraph indent of 5 characters, and word separator of "-" in addition to the defaults of space and tab.

FILL (CURRENT_BUFFER, "-", 10, 70, 5)

Errors:

TPU$_BADMARGINS Invalid margin value.

TPU$_CONTROLC Execution aborted by [CTRL-C].

TPU$_INVRANGE Invalid range.

TPU$_NOCACHE Insufficient memory for new cache.

TPU$_NOTMODIFIABLE Current buffer is READ_ONLY.