Originální popis anglicky: vi - screen-oriented (visual) display editor

Návod, kniha: POSIX Programmer's Manual

STRUČNĚ

vi [-rR][-c command][-t tagstring][-w size][file ...]

POPIS / INSTRUKCE

This utility shall be provided on systems that both support the User Portability Utilities option and define the POSIX2_CHAR_TERM symbol. On other systems it is optional.

The vi (visual) utility is a screen-oriented text editor. Only the open and visual modes of the editor are described in IEEE Std 1003.1-2001; see the line editor ex for additional editing capabilities used in vi. The user can switch back and forth between vi and ex and execute ex commands from within vi.

This reference page uses the term edit buffer to describe the current working text. No specific implementation is implied by this term. All editing changes are performed on the edit buffer, and no changes to it shall affect any file until an editor command writes the file.

When using vi, the terminal screen acts as a window into the editing buffer. Changes made to the editing buffer shall be reflected in the screen display; the position of the cursor on the screen shall indicate the position within the editing buffer.

Certain terminals do not have all the capabilities necessary to support the complete vi definition. When these commands cannot be supported on such terminals, this condition shall not produce an error message such as "not an editor command" or report a syntax error. The implementation may either accept the commands and produce results on the screen that are the result of an unsuccessful attempt to meet the requirements of this volume of IEEE Std 1003.1-2001 or report an error describing the terminal-related deficiency.

OPTIONS

The vi utility shall conform to the Base Definitions volume of IEEE Std 1003.1-2001, Section 12.2, Utility Syntax Guidelines.

The following options shall be supported:

-c command: See the ex command description of the -c option.

-r: See the ex command description of the -r option.

-R: See the ex command description of the -R option.

-t tagstring: See the ex command description of the -t option.

-w size: See the ex command description of the -w option.

OPERANDS

See the OPERANDS section of the ex command for a description of the operands supported by the vi command.

STDIN

If standard input is not a terminal device, the results are undefined. The standard input consists of a series of commands and input text, as described in the EXTENDED DESCRIPTION section.

If a read from the standard input returns an error, or if the editor detects an end-of-file condition from the standard input, it shall be equivalent to a SIGHUP asynchronous event.

INPUT FILES

See the INPUT FILES section of the ex command for a description of the input files supported by the vi command.

ENVIRONMENT VARIABLES

See the ENVIRONMENT VARIABLES section of the ex command for the environment variables that affect the execution of the vi command.

ASYNCHRONOUS EVENTS

See the ASYNCHRONOUS EVENTS section of the ex for the asynchronous events that affect the execution of the vi command.

STDOUT

If standard output is not a terminal device, undefined results occur.

Standard output may be used for writing prompts to the user, for informational messages, and for writing lines from the file.

STDERR

If standard output is not a terminal device, undefined results occur.

The standard error shall be used only for diagnostic messages.

OUTPUT FILES

See the OUTPUT FILES section of the ex command for a description of the output files supported by the vi command.

EXTENDED DESCRIPTION

If the terminal does not have the capabilities necessary to support an unspecified portion of the vi definition, implementations shall start initially in ex mode or open mode. Otherwise, after initialization, vi shall be in command mode; text input mode can be entered by one of several commands used to insert or change text. In text input mode, <ESC> can be used to return to command mode; other uses of <ESC> are described later in this section; see Terminate Command or Input Mode .

Initialization in ex and vi

See Initialization in ex and vi for a description of ex and vi initialization for the vi utility.

Command Descriptions in vi

The following symbols are used in this reference page to represent arguments to commands.

buffer: See the description of buffer in the EXTENDED DESCRIPTION section of the ex utility; see Command Descriptions in ex .

In open and visual mode, when a command synopsis shows both [ buffer] and [ count] preceding the command name, they can be specified in either order.

count: A positive integer used as an optional argument to most commands, either to give a repeat count or as a size. This argument is optional and shall default to 1 unless otherwise specified.

The Synopsis lines for the vi commands <control>-G, <control>-L, <control>-R, <control>-], %, &, ^, D, m, M, Q, u, U, and ZZ do not have count as an optional argument. Regardless, it shall not be an error to specify a count to these commands, and any specified count shall be ignored.

motion: An optional trailing argument used by the !, <, >, c, d, and y commands, which is used to indicate the region of text that shall be affected by the command. The motion can be either one of the command characters repeated or one of several other vi commands (listed in the following table). Each of the applicable commands specifies the region of text matched by repeating the command; each command that can be used as a motion command specifies the region of text it affects.

Commands that take motion arguments operate on either lines or characters, depending on the circumstances. When operating on lines, all lines that fall partially or wholly within the text region specified for the command shall be affected. When operating on characters, only the exact characters in the specified text region shall be affected. Each motion command specifies this individually.

When commands that may be motion commands are not used as motion commands, they shall set the current position to the current line and column as specified.

The following commands shall be valid cursor motion commands:


<apostrophe>       (    -    j    H
<carriage-return>  )    $    k    L
<comma>            [[   %    l    M
<control>-H        ]]   _    n    N
<control>-N        {    ;    t    T
<control>-P        }    ?    w    W
<grave accent>     ^    b    B
<newline>          +    e    E
<space>            |    f    F
<zero>             /    h    G

Any count that is specified to a command that has an associated motion command shall be applied to the motion command. If a count is applied to both the command and its associated motion command, the effect shall be multiplicative.

The following symbols are used in this section to specify locations in the edit buffer:

current character: The character that is currently indicated by the cursor.

end of a line: The point located between the last non- <newline> (if any) and the terminating <newline> of a line. For an empty line, this location coincides with the beginning of the line.

end of the edit buffer: The location corresponding to the end of the last line in the edit buffer.

The following symbols are used in this section to specify command actions:

bigword: In the POSIX locale, vi shall recognize four kinds of bigwords:

1.: A maximal sequence of non- <blank>s preceded and followed by <blank>s or the beginning or end of a line or the edit buffer

2.: One or more sequential blank lines

3.: The first character in the edit buffer

4.: The last non- <newline> in the edit buffer

word: In the POSIX locale, vi shall recognize five kinds of words:

1.: A maximal sequence of letters, digits, and underscores, delimited at both ends by:

*: Characters other than letters, digits, or underscores

*: The beginning or end of a line

*: The beginning or end of the edit buffer

2.: A maximal sequence of characters other than letters, digits, underscores, or <blank>s, delimited at both ends by:

*: A letter, digit, underscore

*: <blank>s

*: The beginning or end of a line

*: The beginning or end of the edit buffer

3.: One or more sequential blank lines

4.: The first character in the edit buffer

5.: The last non- <newline> in the edit buffer

section boundary: A section boundary is one of the following:

1.: A line whose first character is a <form-feed>

2.: A line whose first character is an open curly brace ( '{' )

3.: A line whose first character is a period and whose second and third characters match a two-character pair in the sections edit option (see ed)

4.: A line whose first character is a period and whose only other character matches the first character of a two-character pair in the sections edit option, where the second character of the two-character pair is a <space>

5.: The first line of the edit buffer

6.: The last line of the edit buffer if the last line of the edit buffer is empty or if it is a ]] or } command; otherwise, the last non- <newline> of the last line of the edit buffer

paragraph boundary: A paragraph boundary is one of the following:

1.: A section boundary

2.: A line whose first character is a period and whose second and third characters match a two-character pair in the paragraphs edit option (see ed)

3.: A line whose first character is a period and whose only other character matches the first character of a two-character pair in the paragraphs edit option, where the second character of the two-character pair is a <space>

4.: One or more sequential blank lines

remembered search direction: See the description of remembered search direction in ed.

sentence boundary: A sentence boundary is one of the following:

1.: A paragraph boundary

2.: The first non- <blank> that occurs after a paragraph boundary

3.: The first non- <blank> that occurs after a period ( '.' ), exclamation mark ( '!' ), or question mark ( '?' ), followed by two <space>s or the end of a line; any number of closing parenthesis ( ')' ), closing brackets ( ']' ), double quote ( ' ),' or single quote ( '" ) characters can appear between the punctuation mark and the two <space>s or end-of-line

In the remainder of the description of the vi utility, the term "buffer line" refers to a line in the edit buffer and the term "display line" refers to the line or lines on the display screen used to display one buffer line. The term "current line" refers to a specific "buffer line".

If there are display lines on the screen for which there are no corresponding buffer lines because they correspond to lines that would be after the end of the file, they shall be displayed as a single tilde ( '~' ) character, plus the terminating <newline>.

The last line of the screen shall be used to report errors or display informational messages. It shall also be used to display the input for "line-oriented commands" ( /, ?, :, and !). When a line-oriented command is executed, the editor shall enter text input mode on the last line on the screen, using the respective command characters as prompt characters. (In the case of the ! command, the associated motion shall be entered by the user before the editor enters text input mode.) The line entered by the user shall be terminated by a <newline>, a non- <control>-V-escaped <carriage-return>, or unescaped <ESC>. It is unspecified if more characters than require a display width minus one column number of screen columns can be entered.

If any command is executed that overwrites a portion of the screen other than the last line of the screen (for example, the ex suspend or ! commands), other than the ex shell command, the user shall be prompted for a character before the screen is refreshed and the edit session continued.

<tab>s shall take up the number of columns on the screen set by the tabstop edit option (see ed), unless there are less than that number of columns before the display margin that will cause the displayed line to be folded; in this case, they shall only take up the number of columns up to that boundary.

The cursor shall be placed on the current line and relative to the current column as specified by each command described in the following sections.

In open mode, if the current line is not already displayed, then it shall be displayed.

In visual mode, if the current line is not displayed, then the lines that are displayed shall be expanded, scrolled, or redrawn to cause an unspecified portion of the current line to be displayed. If the screen is redrawn, no more than the number of display lines specified by the value of the window edit option shall be displayed (unless the current line cannot be completely displayed in the number of display lines specified by the window edit option) and the current line shall be positioned as close to the center of the displayed lines as possible (within the constraints imposed by the distance of the line from the beginning or end of the edit buffer). If the current line is before the first line in the display and the screen is scrolled, an unspecified portion of the current line shall be placed on the first line of the display. If the current line is after the last line in the display and the screen is scrolled, an unspecified portion of the current line shall be placed on the last line of the display.

In visual mode, if a line from the edit buffer (other than the current line) does not entirely fit into the lines at the bottom of the display that are available for its presentation, the editor may choose not to display any portion of the line. The lines of the display that do not contain text from the edit buffer for this reason shall each consist of a single '@' character.

In visual mode, the editor may choose for unspecified reasons to not update lines in the display to correspond to the underlying edit buffer text. The lines of the display that do not correctly correspond to text from the edit buffer for this reason shall consist of a single '@' character (plus the terminating <newline>), and the <control>-R command shall cause the editor to update the screen to correctly represent the edit buffer.

Open and visual mode commands that set the current column set it to a column position in the display, and not a character position in the line. In this case, however, the column position in the display shall be calculated for an infinite width display; for example, the column related to a character that is part of a line that has been folded onto additional screen lines will be offset from the display line column where the buffer line begins, not from the beginning of a particular display line.

The display cursor column in the display is based on the value of the current column, as follows, with each rule applied in turn:

1.: If the current column is after the last display line column used by the displayed line, the display cursor column shall be set to the last display line column occupied by the last non- <newline> in the current line; otherwise, the display cursor column shall be set to the current column.

2.: If the character of which some portion is displayed in the display line column specified by the display cursor column requires more than a single display line column:

a.: If in text input mode, the display cursor column shall be adjusted to the first display line column in which any portion of that character is displayed.

b.: Otherwise, the display cursor column shall be adjusted to the last display line column in which any portion of that character is displayed.

The current column shall not be changed by these adjustments to the display cursor column.

If an error occurs during the parsing or execution of a vi command:

*: The terminal shall be alerted. Execution of the vi command shall stop, and the cursor (for example, the current line and column) shall not be further modified.

*: Unless otherwise specified by the following command sections, it is unspecified whether an informational message shall be displayed.

*: Any partially entered vi command shall be discarded.

*: If the vi command resulted from a map expansion, all characters from that map expansion shall be discarded, except as otherwise specified by the map command (see ed).

*: If the vi command resulted from the execution of a buffer, no further commands caused by the execution of the buffer shall be executed.

Page Backwards

Synopsis:


[count] <control>-B

If in open mode, the <control>-B command shall behave identically to the z command. Otherwise, if the current line is the first line of the edit buffer, it shall be an error.

If the window edit option is less than 3, display a screen where the last line of the display shall be some portion of:


(current first line) -1

otherwise, display a screen where the first line of the display shall be some portion of:


(current first line) - count x ((window edit option) -2)

If this calculation would result in a line that is before the first line of the edit buffer, the first line of the display shall display some portion of the first line of the edit buffer.

Current line: If no lines from the previous display remain on the screen, set to the last line of the display; otherwise, set to ( line - the number of new lines displayed on this screen).

Current column: Set to non- <blank>.

Scroll Forward

Synopsis:


[count] <control>-D

If the current line is the last line of the edit buffer, it shall be an error.

If no count is specified, count shall default to the count associated with the previous <control>-D or <control>-U command. If there was no previous <control>-D or <control>-U command, count shall default to the value of the scroll edit option.

If in open mode, write lines starting with the line after the current line, until count lines or the last line of the file have been written.

Current line: If the current line + count is past the last line of the edit buffer, set to the last line of the edit buffer; otherwise, set to the current line + count.

Current column: Set to non- <blank>.

Scroll Forward by Line

Synopsis:


[count] <control>-E

Display the line count lines after the last line currently displayed.

If the last line of the edit buffer is displayed, it shall be an error. If there is no line count lines after the last line currently displayed, the last line of the display shall display some portion of the last line of the edit buffer.

Current line: Unchanged if the previous current character is displayed; otherwise, set to the first line displayed.

Current column: Unchanged.

Page Forward

Synopsis:


[count] <control>-F

If in open mode, the <control>-F command shall behave identically to the z command. Otherwise, if the current line is the last line of the edit buffer, it shall be an error.

If the window edit option is less than 3, display a screen where the first line of the display shall be some portion of:


(current last line) +1

otherwise, display a screen where the first line of the display shall be some portion of:


(current first line) + count x ((window edit option) -2)

If this calculation would result in a line that is after the last line of the edit buffer, the last line of the display shall display some portion of the last line of the edit buffer.

Current line: If no lines from the previous display remain on the screen, set to the first line of the display; otherwise, set to ( line + the number of new lines displayed on this screen).

Current column: Set to non- <blank>.

Display Information

Synopsis:


<control>-G

This command shall be equivalent to the ex file command.

Move Cursor Backwards

Synopsis:


[count] <control>-H
 

[count] h
 

the current  erase character (see stty)

If there are no characters before the current character on the current line, it shall be an error. If there are less than count previous characters on the current line, count shall be adjusted to the number of previous characters on the line.

If used as a motion command:

1.: The text region shall be from the character before the starting cursor up to and including the countth character before the starting cursor.

2.: Any text copied to a buffer shall be in character mode.

If not used as a motion command:

Current line: Unchanged.

Current column: Set to ( column - the number of columns occupied by count characters ending with the previous current column).

Move Down

Synopsis:


[count] <newline>
 

[count] <control>-J
 

[count] <control>-M
 

[count] <control>-N
 

[count] j
 

[count] <carriage-return>
 

[count] +

If there are less than count lines after the current line in the edit buffer, it shall be an error.

If used as a motion command:

1.: The text region shall include the starting line and the next count - 1 lines.

2.: Any text copied to a buffer shall be in line mode.

If not used as a motion command:

Current line: Set to current line+ count.

Current column: Set to non- <blank> for the <carriage-return>, <control>-M, and + commands; otherwise, unchanged.

Clear and Redisplay

Synopsis:


<control>-L

If in open mode, clear the screen and redisplay the current line. Otherwise, clear and redisplay the screen.

Current line: Unchanged.

Current column: Unchanged.

Move Up

Synopsis:


[count] <control>-P
 

[count] k
 

[count] -

If there are less than count lines before the current line in the edit buffer, it shall be an error.

If used as a motion command:

1.: The text region shall include the starting line and the previous count lines.

2.: Any text copied to a buffer shall be in line mode.

If not used as a motion command:

Current line: Set to current line - count.

Current column: Set to non- <blank> for the - command; otherwise, unchanged.

Redraw Screen

Synopsis:


<control>-R

If any lines have been deleted from the display screen and flagged as deleted on the terminal using the @ convention (see the beginning of the EXTENDED DESCRIPTION section), they shall be redisplayed to match the contents of the edit buffer.

It is unspecified whether lines flagged with @ because they do not fit on the terminal display shall be affected.

Current line: Unchanged.

Current column: Unchanged.

Scroll Backward

Synopsis:


[count] <control>-U

If the current line is the first line of the edit buffer, it shall be an error.

Current line: If count is greater than the current line, set to 1; otherwise, set to the current line - count.

Current column: Set to non- <blank>.

Scroll Backward by Line

Synopsis:


[count] <control>-Y

Display the line count lines before the first line currently displayed.

If the current line is the first line of the edit buffer, it shall be an error. If this calculation would result in a line that is before the first line of the edit buffer, the first line of the display shall display some portion of the first line of the edit buffer.

Current line: Unchanged if the previous current character is displayed; otherwise, set to the first line displayed.

Current column: Unchanged.

Edit the Alternate File

Synopsis:


<control>-^

This command shall be equivalent to the ex edit command, with the alternate pathname as its argument.

Terminate Command or Input Mode

Synopsis:


<ESC>

If a partial vi command (as defined by at least one, non- count character) has been entered, discard the count and the command character(s).

Otherwise, if no command characters have been entered, and the <ESC> was the result of a map expansion, the terminal shall be alerted and the <ESC> character shall be discarded, but it shall not be an error.

Otherwise, it shall be an error.

Current line: Unchanged.

Current column: Unchanged.

Search for tagstring

Synopsis:


<control>-]

If the current character is not a word or <blank>, it shall be an error.

This command shall be equivalent to the ex tag command, with the argument to that command defined as follows.

If the current character is a <blank>:

1.: Skip all <blank>s after the cursor up to the end of the line.

2.: If the end of the line is reached, it shall be an error.

Then, the argument to the ex tag command shall be the current character and all subsequent characters, up to the first non-word character or the end of the line.

Move Cursor Forward

Synopsis:


[count] <space>
 

[count] l  (ell)

If there are less than count non- <newline>s after the cursor on the current line, count shall be adjusted to the number of non- <newline>s after the cursor on the line.

If used as a motion command:

1.: If the current or countth character after the cursor is the last non- <newline> in the line, the text region shall be comprised of the current character up to and including the last non- <newline> in the line. Otherwise, the text region shall be from the current character up to, but not including, the countth character after the cursor.

2.: Any text copied to a buffer shall be in character mode.

If not used as a motion command:

If there are no non- <newline>s after the current character on the current line, it shall be an error.

Current line: Unchanged.

Current column: Set to the last column that displays any portion of the countth character after the current character.

Replace Text with Results from Shell Command

Synopsis:


[count] ! motion shell-commands <newline>

If the motion command is the ! command repeated:

1.: If the edit buffer is empty and no count was supplied, the command shall be the equivalent of the ex :read ! command, with the text input, and no text shall be copied to any buffer.

2.: Otherwise:

a.: If there are less than count -1 lines after the current line in the edit buffer, it shall be an error.

b.: The text region shall be from the current line up to and including the next count -1 lines.

Otherwise, the text region shall be the lines in which any character of the text region specified by the motion command appear.

Any text copied to a buffer shall be in line mode.

This command shall be equivalent to the ex ! command for the specified lines.

Move Cursor to End-of-Line

Synopsis:


[count] $

It shall be an error if there are less than ( count -1) lines after the current line in the edit buffer.

If used as a motion command:

1.: If count is 1:

a.: It shall be an error if the line is empty.

b.: Otherwise, the text region shall consist of all characters from the starting cursor to the last non- <newline> in the line, inclusive, and any text copied to a buffer shall be in character mode.

2.: Otherwise, if the starting cursor position is at or before the first non- <blank> in the line, the text region shall consist of the current and the next count -1 lines, and any text saved to a buffer shall be in line mode.

3.: Otherwise, the text region shall consist of all characters from the starting cursor to the last non- <newline> in the line that is count -1 lines forward from the current line, and any text copied to a buffer shall be in character mode.

If not used as a motion command:

Current line: Set to the current line + count-1.

Current column: The current column is set to the last display line column of the last non- <newline> in the line, or column position 1 if the line is empty.

The current column shall be adjusted to be on the last display line column of the last non- <newline> of the current line as subsequent commands change the current line, until a command changes the current column.

Move to Matching Character

Synopsis:

If the character at the current position is not a parenthesis, bracket, or curly brace, search forward in the line to the first one of those characters. If no such character is found, it shall be an error.

The matching character shall be the parenthesis, bracket, or curly brace matching the parenthesis, bracket, or curly brace, respectively, that was at the current position or that was found on the current line.

Matching shall be determined as follows, for an open parenthesis:

1.: Set a counter to 1.

2.: Search forwards until a parenthesis is found or the end of the edit buffer is reached.

3.: If the end of the edit buffer is reached, it shall be an error.

4.: If an open parenthesis is found, increment the counter by 1.

5.: If a close parenthesis is found, decrement the counter by 1.

6.: If the counter is zero, the current character is the matching character.

Matching for a close parenthesis shall be equivalent, except that the search shall be backwards, from the starting character to the beginning of the buffer, a close parenthesis shall increment the counter by 1, and an open parenthesis shall decrement the counter by 1.

Matching for brackets and curly braces shall be equivalent, except that searching shall be done for open and close brackets or open and close curly braces. It is implementation-defined whether other characters are searched for and matched as well.

If used as a motion command:

1.: If the matching cursor was after the starting cursor in the edit buffer, and the starting cursor position was at or before the first non- <blank> non- <newline> in the starting line, and the matching cursor position was at or after the last non- <blank> non- <newline> in the matching line, the text region shall consist of the current line to the matching line, inclusive, and any text copied to a buffer shall be in line mode.

2.: If the matching cursor was before the starting cursor in the edit buffer, and the starting cursor position was at or after the last non- <blank> non- <newline> in the starting line, and the matching cursor position was at or before the first non- <blank> non- <newline> in the matching line, the text region shall consist of the current line to the matching line, inclusive, and any text copied to a buffer shall be in line mode.

3.: Otherwise, the text region shall consist of the starting character to the matching character, inclusive, and any text copied to a buffer shall be in character mode.

If not used as a motion command:

Current line: Set to the line where the matching character is located.

Current column: Set to the last column where any portion of the matching character is displayed.

Repeat Substitution

Synopsis:

Repeat the previous substitution command. This command shall be equivalent to the ex & command with the current line as its addresses, and without options, count, or flags.

Return to Previous Context at Beginning of Line

Synopsis:


' character

It shall be an error if there is no line in the edit buffer marked by character.

If used as a motion command:

1.: If the starting cursor is after the marked cursor, then the locations of the starting cursor and the marked cursor in the edit buffer shall be logically swapped.

2.: The text region shall consist of the starting line up to and including the marked line, and any text copied to a buffer shall be in line mode.

If not used as a motion command:

Current line: Set to the line referenced by the mark.

Current column: Set to non- <blank>.

Return to Previous Context

Synopsis:


` character

It shall be an error if the marked line is no longer in the edit buffer. If the marked line no longer contains a character in the saved numbered character position, it shall be as if the marked position is the first non- <blank>.

If used as a motion command:

1.: It shall be an error if the marked cursor references the same character in the edit buffer as the starting cursor.

2.: If the starting cursor is after the marked cursor, then the locations of the starting cursor and the marked cursor in the edit buffer shall be logically swapped.

3.: If the starting line is empty or the starting cursor is at or before the first non- <blank> non- <newline> of the starting line, and the marked cursor line is empty or the marked cursor references the first character of the marked cursor line, the text region shall consist of all lines containing characters from the starting cursor to the line before the marked cursor line, inclusive, and any text copied to a buffer shall be in line mode.

4.: Otherwise, if the marked cursor line is empty or the marked cursor references a character at or before the first non- <blank> non- <newline> of the marked cursor line, the region of text shall be from the starting cursor to the last non- <newline> of the line before the marked cursor line, inclusive, and any text copied to a buffer shall be in character mode.

5.: Otherwise, the region of text shall be from the starting cursor (inclusive), to the marked cursor (exclusive), and any text copied to a buffer shall be in character mode.

If not used as a motion command:

Current line: Set to the line referenced by the mark.

Current column: Set to the last column in which any portion of the character referenced by the mark is displayed.

Return to Previous Section

Synopsis:


[count] [[

Move the cursor backward through the edit buffer to the first character of the previous section boundary, count times.

If used as a motion command:

1.: If the starting cursor was at the first character of the starting line or the starting line was empty, and the first character of the boundary was the first character of the boundary line, the text region shall consist of the current line up to and including the line where the countth next boundary starts, and any text copied to a buffer shall be in line mode.

2.: If the boundary was the last line of the edit buffer or the last non- <newline> of the last line of the edit buffer, the text region shall consist of the last character in the edit buffer up to and including the starting character, and any text saved to a buffer shall be in character mode.

3.: Otherwise, the text region shall consist of the starting character up to but not including the first character in the countth next boundary, and any text copied to a buffer shall be in character mode.

If not used as a motion command:

Current line: Set to the line where the countth next boundary in the edit buffer starts.

Current column: Set to the last column in which any portion of the first character of the countth next boundary is displayed, or column position 1 if the line is empty.

Move to Next Section

Synopsis:


[count] ]]

Move the cursor forward through the edit buffer to the first character of the next section boundary, count times.

If used as a motion command:

1.: If the starting cursor was at the first character of the starting line or the starting line was empty, and the first character of the boundary was the first character of the boundary line, the text region shall consist of the current line up to and including the line where the countth previous boundary starts, and any text copied to a buffer shall be in line mode.

2.: If the boundary was the first line of the edit buffer, the text region shall consist of the first character in the edit buffer up to but not including the starting character, and any text copied to a buffer shall be in character mode.

3.: Otherwise, the text region shall consist of the first character in the countth previous section boundary up to but not including the starting character, and any text copied to a buffer shall be in character mode.

If not used as a motion command:

Current line: Set to the line where the countth previous boundary in the edit buffer starts.

Current column: Set to the last column in which any portion of the first character of the countth previous boundary is displayed, or column position 1 if the line is empty.

Move to First Non-<blank> Position on Current Line

Synopsis:

If used as a motion command:

1.: If the line has no non- <blank> non- <newline>s, or if the cursor is at the first non- <blank> non- <newline> of the line, it shall be an error.

2.: If the cursor is before the first non- <blank> non- <newline> of the line, the text region shall be