add Command

Adds one or more blank lines.

Scope: File

Syntax

Parameter

Number 
The number of blank lines to add. The default is 1; it must be a positive integer.

Description

The add command adds one or more lines following the current line (or sequence of flowed lines). Each new line consists of a single blank on a new line.

To add a line at the top of the file (before the first line), move to the first character in the file and then use the splitjoin command to create a new blank line.

Example

To add five new lines after the current line, type:

add 5 

API Return Codes

-1 
The number specified was either outside the valid range or not a whole number. Issue the command again using a valid number.
-5 
You cannot make changes to the file because the readonly parameter is set to on.

splitjoin Command