Removing elvis, importing nvi, ctags, updating libedit. Change-Id: I881eb04d2dc64cf112facd992de1114e1a59107f
3097 lines
69 KiB
Text
3097 lines
69 KiB
Text
.\" $NetBSD: vi.cmd.roff,v 1.1 2008/09/02 09:25:39 christos Exp $
|
|
.\"
|
|
.\" Copyright (c) 1994
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\" Copyright (c) 1994, 1995, 1996
|
|
.\" Keith Bostic. All rights reserved.
|
|
.\"
|
|
.\" See the LICENSE file for redistribution information.
|
|
.\"
|
|
.\" @(#)vi.cmd.roff 8.49 (Berkeley) 8/17/96
|
|
.\"
|
|
.SH 1 "Vi Description"
|
|
.pp
|
|
.CO Vi
|
|
takes up the entire screen to display the edited file,
|
|
except for the bottom line of the screen.
|
|
The bottom line of the screen is used to enter
|
|
.CO ex
|
|
commands, and for
|
|
.CO vi
|
|
error and informational messages.
|
|
If no other information is being displayed,
|
|
the default display can show the current cursor row and cursor column,
|
|
an indication of whether the file has been modified,
|
|
and the current mode of the editor.
|
|
See the
|
|
.OP ruler
|
|
and
|
|
.OP showmode
|
|
options for more information.
|
|
.pp
|
|
Empty lines do not have any special representation on the screen,
|
|
but lines on the screen that would logically come after the end of
|
|
the file are displayed as a single tilde
|
|
.PQ ~
|
|
character.
|
|
To differentiate between empty lines and lines consisting of only
|
|
whitespace characters, use the
|
|
.OP list
|
|
option.
|
|
Historically, implementations of
|
|
.CO vi
|
|
have also displayed some lines as single asterisk
|
|
.PQ @
|
|
characters.
|
|
These were lines that were not correctly displayed, i.e. lines on the
|
|
screen that did not correspond to lines in the file, or lines that did
|
|
not fit on the current screen.
|
|
.CO Nvi
|
|
never displays lines in this fashion.
|
|
.pp
|
|
.CO Vi
|
|
is a modeful editor, i.e. it has two modes,
|
|
.QQ command
|
|
mode and
|
|
.QQ "text input"
|
|
mode.
|
|
When
|
|
.CO vi
|
|
first starts, it is in command mode.
|
|
There are several commands that change
|
|
.CO vi
|
|
into text input mode.
|
|
The
|
|
.LI <escape>
|
|
character is used to resolve the text input into the file,
|
|
and exit back into command mode.
|
|
In
|
|
.CO vi
|
|
command mode, the cursor is always positioned on the last column of
|
|
characters which take up more than one column on the screen.
|
|
In
|
|
.CO vi
|
|
text insert mode, the cursor is positioned on the first column of
|
|
characters which take up more than one column on the screen.
|
|
.pp
|
|
When positioning the cursor to a new line and column,
|
|
the type of movement is defined by the distance to the new cursor position.
|
|
If the new position is close,
|
|
the screen is scrolled to the new location.
|
|
If the new position is far away,
|
|
the screen is repainted so that the new position is on the screen.
|
|
If the screen is scrolled,
|
|
it is moved a minimal amount,
|
|
and the cursor line will usually appear at the top or bottom of the screen.
|
|
If the screen is repainted,
|
|
the cursor line will appear in the center of the screen,
|
|
unless the cursor is sufficiently close to the beginning or end of the file
|
|
that this isn't possible.
|
|
If the
|
|
.OP leftright
|
|
option is set, the screen may be scrolled or repainted in a horizontal
|
|
direction as well as in a vertical one.
|
|
.pp
|
|
A major difference between the historical
|
|
.CO vi
|
|
presentation and
|
|
.CO nvi
|
|
is in the scrolling and screen oriented position commands,
|
|
.CO <control-B> ,
|
|
.CO <control-D> ,
|
|
.CO <control-E> ,
|
|
.CO <control-F> ,
|
|
.CO <control-U> ,
|
|
.CO <control-Y> ,
|
|
.CO H ,
|
|
.CO L
|
|
and
|
|
.CO M .
|
|
In historical implementations of
|
|
.CO vi ,
|
|
these commands acted on physical (as opposed to logical, or screen)
|
|
lines.
|
|
For lines that were sufficiently long in relation to the size of the
|
|
screen, this meant that single line scroll commands might repaint the
|
|
entire screen, scrolling or screen positioning commands might not change
|
|
the screen or move the cursor at all, and some lines simply could not
|
|
be displayed, even though
|
|
.CO vi
|
|
would edit the file that contained them.
|
|
In
|
|
.CO nvi ,
|
|
these commands act on logical, i.e. screen lines.
|
|
You are unlikely to notice any difference unless you are editing files
|
|
with lines significantly longer than a screen width.
|
|
.pp
|
|
.CO Vi
|
|
keeps track of the currently
|
|
.QQ "most attractive"
|
|
cursor position.
|
|
Each command description (for commands that alter the current cursor
|
|
position),
|
|
specifies if the cursor is set to a specific location in the line,
|
|
or if it is moved to the
|
|
.QQ "most attractive cursor position" .
|
|
The latter means that the cursor is moved to the cursor position that
|
|
is horizontally as close as possible to the current cursor position.
|
|
If the current line is shorter than the cursor position
|
|
.CO vi
|
|
would select, the cursor is positioned on the last character in the line.
|
|
(If the line is empty, the cursor is positioned on the first column
|
|
of the line.)
|
|
If a command moves the cursor to the most attractive position,
|
|
it does not alter the current cursor position, and a subsequent
|
|
movement will again attempt to move the cursor to that position.
|
|
Therefore, although a movement to a line shorter than the currently
|
|
most attractive position will cause the cursor to move to the end of
|
|
that line, a subsequent movement to a longer line will cause the
|
|
cursor to move back to the most attractive position.
|
|
.pp
|
|
In addition, the
|
|
.CO $
|
|
command makes the end of each line the most attractive cursor position
|
|
rather than a specific column.
|
|
.pp
|
|
Each
|
|
.CO vi
|
|
command described below notes where the cursor ends up after it is
|
|
executed.
|
|
This position is described in terms of characters on the line, i.e.
|
|
.QQ "the previous character" ,
|
|
or,
|
|
.QQ "the last character in the line" .
|
|
This is to avoid needing to continually refer to on what part of the
|
|
character the cursor rests.
|
|
.pp
|
|
The following words have special meaning for
|
|
.CO vi
|
|
commands.
|
|
.KY "previous context"
|
|
.IP "previous context"
|
|
The position of the cursor before the command which caused the
|
|
last absolute movement was executed.
|
|
Each
|
|
.CO vi
|
|
command described in the next section that is considered an
|
|
absolute movement is so noted.
|
|
In addition, specifying
|
|
.i any
|
|
address to an
|
|
.CO ex
|
|
command is considered an absolute movement.
|
|
.KY "motion"
|
|
.IP "motion"
|
|
A second
|
|
.CO vi
|
|
command can be used as an optional trailing argument to the
|
|
.CO vi
|
|
.CO \&< ,
|
|
.CO \&> ,
|
|
.CO \&! ,
|
|
.CO \&c ,
|
|
.CO \&d ,
|
|
.CO \&y ,
|
|
and (depending on the
|
|
.OP tildeop
|
|
option)
|
|
.CO \&~
|
|
commands.
|
|
This command indicates the end of the region of text that's affected by
|
|
the command.
|
|
The motion command may be either the command character repeated (in
|
|
which case it means the current line) or a cursor movement command.
|
|
In the latter case, the region affected by the command is from the
|
|
starting or stopping cursor position which comes first in the file,
|
|
to immediately before the starting or stopping cursor position which
|
|
comes later in the file.
|
|
Commands that operate on lines instead of using beginning and ending
|
|
cursor positions operate on all of the lines that are wholly or
|
|
partially in the region.
|
|
In addition, some other commands become line oriented depending on
|
|
where in the text they are used.
|
|
The command descriptions below note these special cases.
|
|
.sp
|
|
The following commands may all be used as motion components for
|
|
.CO vi
|
|
commands:
|
|
.sp
|
|
.ne 12v
|
|
.ft C
|
|
.TS
|
|
r r r r.
|
|
<control-A> <control-H> <control-J> <control-M>
|
|
<control-N> <control-P> <space> $
|
|
% '<character> ( )
|
|
+ , - /
|
|
0 ; ? B
|
|
E F G H
|
|
L M N T
|
|
W [[ ]] ^
|
|
\&_ `<character> b e
|
|
f h j k
|
|
l n t w
|
|
{ | }
|
|
.TE
|
|
.ft R
|
|
.sp
|
|
The optional count prefix available for some of the
|
|
.CO vi
|
|
commands that take motion commands,
|
|
or the count prefix available for the
|
|
.CO vi
|
|
commands that are used as motion components,
|
|
may be included and is
|
|
.i always
|
|
considered part of the motion argument.
|
|
For example, the commands
|
|
.QT c2w
|
|
and
|
|
.QT 2cw
|
|
are equivalent, and the region affected by the
|
|
.CO c
|
|
command is two words of text.
|
|
In addition,
|
|
if the optional count prefix is specified for both the
|
|
.CO vi
|
|
command and its motion component,
|
|
the effect is multiplicative and is considered part of the motion argument.
|
|
For example, the commands
|
|
.QT 4cw
|
|
and
|
|
.QT 2c2w
|
|
are equivalent, and the region affected by the
|
|
.CO c
|
|
command is four words of text.
|
|
.KY "count"
|
|
.IP "count"
|
|
A positive number used as an optional argument to most commands,
|
|
either to give a size or a position (for display or movement commands),
|
|
or as a repeat count (for commands that modify text).
|
|
The count argument is always optional and defaults to 1 unless otherwise
|
|
noted in the command description.
|
|
.sp
|
|
When a
|
|
.CO vi
|
|
command synopsis shows both a
|
|
.LI [buffer]
|
|
and
|
|
.LI [count] ,
|
|
they may be presented in any order.
|
|
.KY word
|
|
.IP word
|
|
Generally, in languages where it is applicable,
|
|
.CO vi
|
|
recognizes two kinds of words.
|
|
First, a 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, and the beginning or end of the file.
|
|
Second, a sequence of characters other than letters, digits, underscores,
|
|
or whitespace characters, delimited at both ends by: a letter, digit,
|
|
underscore, or whitespace character,
|
|
the beginning or end of a line, and the beginning or end of the file.
|
|
For example, the characters
|
|
.QT " !@#abc$%^ "
|
|
contain three words:
|
|
.QT "!@#" ,
|
|
.QT "abc"
|
|
and
|
|
.QT "$%^" .
|
|
.sp
|
|
Groups of empty lines (or lines containing only whitespace characters)
|
|
are treated as a single word.
|
|
.KY "bigword"
|
|
.IP "bigword"
|
|
A set of non-whitespace characters preceded and followed by whitespace
|
|
characters or the beginning or end of the file or line.
|
|
For example, the characters
|
|
.QT " !@#abc$%^ "
|
|
contain one bigword:
|
|
.QT "!@#abc$%^" .
|
|
.sp
|
|
Groups of empty lines (or lines containing only whitespace characters)
|
|
are treated as a single bigword.
|
|
.KY "paragraph"
|
|
.IP "paragraph"
|
|
An area of text that begins with either the beginning of a file,
|
|
an empty line, or a section boundary, and continues until either
|
|
an empty line, section boundary, or the end of the file.
|
|
.sp
|
|
Groups of empty lines (or lines containing only whitespace characters)
|
|
are treated as a single paragraph.
|
|
.sp
|
|
Additional paragraph boundaries can be defined using the
|
|
.OP paragraphs
|
|
option.
|
|
.KY "section"
|
|
.IP "section"
|
|
An area of text that starts with the beginning of the file or a line
|
|
whose first character is an open brace
|
|
.PQ {
|
|
and continues until the next section or the end of the file.
|
|
.sp
|
|
Additional section boundaries can be defined using the
|
|
.OP sections
|
|
option.
|
|
.KY "sentence"
|
|
.IP "sentence"
|
|
An area of text that begins with either the beginning of the file or the
|
|
first nonblank character following the previous sentence, paragraph, or
|
|
section boundary and continues until the end of the file or a period
|
|
.PQ \&.
|
|
exclamation point
|
|
.PQ !
|
|
or question mark
|
|
.PQ ?
|
|
character,
|
|
followed by either an end-of-line or two whitespace characters.
|
|
Any number of closing parentheses
|
|
.PQ ) ,
|
|
brackets
|
|
.PQ ] ,
|
|
double-quote
|
|
.PQ """"
|
|
or single quote
|
|
.PQ '
|
|
characters can appear between the period, exclamation point,
|
|
or question mark and the whitespace characters or end-of-line.
|
|
.sp
|
|
Groups of empty lines (or lines containing only whitespace characters)
|
|
are treated as a single sentence.
|
|
.SH 1 "Vi Commands"
|
|
.pp
|
|
The following section describes the commands available in the command
|
|
mode of the
|
|
.CO vi
|
|
editor.
|
|
In each entry below, the tag line is a usage synopsis for the command
|
|
character.
|
|
In addition, the final line and column the cursor rests upon,
|
|
and any options which affect the command are noted.
|
|
.KY <control-A>
|
|
.IP "[count] <control-A>"
|
|
Search forward
|
|
.LI count
|
|
times for the current word.
|
|
The current word begins at the first non-whitespace character on or
|
|
after the current cursor position,
|
|
and extends up to the next non-word character or the end of the line.
|
|
The search is literal, i.e. no characters in the word have any special
|
|
meaning in terms of Regular Expressions.
|
|
It is an error if no matching pattern is found between the starting position
|
|
and the end of the file.
|
|
.sp
|
|
The
|
|
.CO <control-A>
|
|
command is an absolute movement.
|
|
The
|
|
.CO <control-A>
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line where the word is found.
|
|
.SP Column:
|
|
Set to the first character of the word.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP ignorecase
|
|
and
|
|
.OP wrapscan
|
|
options.
|
|
.SE
|
|
.KY <control-B>
|
|
.IP "[count] <control-B>"
|
|
Page backward
|
|
.LI count
|
|
screens.
|
|
Two lines of overlap are maintained, if possible,
|
|
by displaying the window starting at line
|
|
.LI "(top_line - count * window_size) + 2" ,
|
|
where
|
|
.LI window_size
|
|
is the value of the
|
|
.OP window
|
|
option.
|
|
(In the case of split screens, this size is corrected to the
|
|
current screen size.)
|
|
It is an error if the movement is past the beginning of the file.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line of text displayed on the screen.
|
|
.SP Column:
|
|
Set to the first nonblank character of the line.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP window
|
|
option.
|
|
.SE
|
|
.KY <control-D>
|
|
.IP "[count] <control-D>"
|
|
Scroll forward
|
|
.LI count
|
|
lines.
|
|
If
|
|
.LI count
|
|
is not specified, scroll forward the number of lines specified by the last
|
|
.CO <control-D>
|
|
or
|
|
.CO <control-U>
|
|
command.
|
|
If this is the first
|
|
.CO <control-D>
|
|
or
|
|
.CO <control-U>
|
|
command,
|
|
scroll forward half the number of lines in the screen.
|
|
(In the case of split screens, the default scrolling distance is
|
|
corrected to half the current screen size.)
|
|
It is an error if the movement is past the end of the file.
|
|
.SS
|
|
.SP Line:
|
|
Set to the current line plus the number of lines scrolled.
|
|
.SP Column:
|
|
Set to the first nonblank character of the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-E>
|
|
.IP "[count] <control-E>"
|
|
Scroll forward
|
|
.LI count
|
|
lines, leaving the cursor on the current line and column, if possible.
|
|
It is an error if the movement is past the end of the file.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged unless the current line scrolls off the screen,
|
|
in which case it is set to the first line on the screen.
|
|
.SP Column:
|
|
Unchanged unless the current line scrolls off the screen,
|
|
in which case it is set to the most attractive cursor position.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-F>
|
|
.IP "[count] <control-F>"
|
|
Page forward
|
|
.LI count
|
|
screens.
|
|
Two lines of overlap are maintained, if possible,
|
|
by displaying the window starting at line
|
|
.LI "top_line + count * window_size - 2" ,
|
|
where
|
|
.LI window_size
|
|
is the value of the
|
|
.OP window
|
|
option.
|
|
(In the case of split screens, this size is corrected to the
|
|
current screen size.)
|
|
It is an error if the movement is past the end of the file.
|
|
.SS
|
|
.SP Line:
|
|
Set to the first line on the screen.
|
|
.SP Column:
|
|
Set to the first nonblank character of the current line.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP window
|
|
option.
|
|
.SE
|
|
.KY <control-G>
|
|
.IP "<control-G>"
|
|
Display the file information.
|
|
The information includes the current pathname, the current line,
|
|
the number of total lines in the file, the current line as a percentage
|
|
of the total lines in the file, if the file has been modified,
|
|
was able to be locked, if the file's name has been changed,
|
|
and if the edit session is read-only.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Unchanged.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-H>
|
|
.IP "[count] <control-H>"
|
|
.Ip "[count] h"
|
|
Move the cursor back
|
|
.LI count
|
|
characters in the current line.
|
|
It is an error if the cursor is on the first character in the line.
|
|
.sp
|
|
The
|
|
.CO <control-H>
|
|
and
|
|
.CO h
|
|
commands may be used as the motion component of other
|
|
.CO vi
|
|
commands,
|
|
in which case any text copied into a buffer is character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the
|
|
.LI "current - count"
|
|
character, or, the first character in the line if
|
|
.LI count
|
|
is greater than or equal to the number of characters in the line
|
|
before the cursor.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-J>
|
|
.IP "[count] <control-J>"
|
|
.KY <control-N>
|
|
.Ip "[count] <control-N>"
|
|
.KY j
|
|
.Ip "[count] j"
|
|
Move the cursor down
|
|
.LI count
|
|
lines without changing the current column.
|
|
It is an error if the movement is past the end of the file.
|
|
.sp
|
|
The
|
|
.CO <control-J> ,
|
|
.CO <control-N>
|
|
and
|
|
.CO j
|
|
commands may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the current line plus
|
|
.LI count .
|
|
.SP Column:
|
|
The most attractive cursor position.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-L>
|
|
.IP "<control-L>"
|
|
.KY <control-R>
|
|
.Ip "<control-R>"
|
|
Repaint the screen.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Unchanged.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-M>
|
|
.IP "[count] <control-M>"
|
|
.KY +
|
|
.Ip "[count] +"
|
|
Move the cursor down
|
|
.LI count
|
|
lines to the first nonblank character of that line.
|
|
It is an error if the movement is past the end of the file.
|
|
.sp
|
|
The
|
|
.CO <control-M>
|
|
and
|
|
.CO +
|
|
commands may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the current line plus
|
|
.LI count .
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-P>
|
|
.IP "[count] <control-P>"
|
|
.KY k
|
|
.Ip "[count] k"
|
|
Move the cursor up
|
|
.LI count
|
|
lines, without changing the current column.
|
|
It is an error if the movement is past the beginning of the file.
|
|
.sp
|
|
The
|
|
.CO <control-P>
|
|
and
|
|
.CO k
|
|
commands may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the current line minus
|
|
.LI count .
|
|
.SP Column:
|
|
The most attractive cursor position.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-T>
|
|
.IP "<control-T>"
|
|
Return to the most recent tag context.
|
|
The
|
|
.CO <control-T>
|
|
command is an absolute movement.
|
|
.SS
|
|
.SP Line:
|
|
Set to the context of the previous tag command.
|
|
.SP Column:
|
|
Set to the context of the previous tag command.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-U>
|
|
.IP "[count] <control-U>"
|
|
Scroll backward
|
|
.LI count
|
|
lines.
|
|
If
|
|
.LI count
|
|
is not specified, scroll backward the number of lines specified by the
|
|
last
|
|
.CO <control-D>
|
|
or
|
|
.CO <control-U>
|
|
command.
|
|
If this is the first
|
|
.CO <control-D>
|
|
or
|
|
.CO <control-U>
|
|
command,
|
|
scroll backward half the number of lines in the screen.
|
|
(In the case of split screens, the default scrolling distance is
|
|
corrected to half the current screen size.)
|
|
It is an error if the movement is past the beginning of the file.
|
|
.SS
|
|
.SP Line:
|
|
Set to the current line minus the amount scrolled.
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-W>
|
|
.IP "<control-W>"
|
|
Switch to the next lower screen in the window, or, to the first
|
|
screen if there are no lower screens in the window.
|
|
.SS
|
|
.SP Line:
|
|
Set to the previous cursor position in the window.
|
|
.SP Column:
|
|
Set to the previous cursor position in the window.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-Y>
|
|
.IP "[count] <control-Y>"
|
|
Scroll backward
|
|
.LI count
|
|
lines, leaving the current line and column as is, if possible.
|
|
It is an error if the movement is past the beginning of the file.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged unless the current line scrolls off the screen,
|
|
in which case it is set to the last line of text displayed
|
|
on the screen.
|
|
.SP Column:
|
|
Unchanged unless the current line scrolls off the screen,
|
|
in which case it is the most attractive cursor position.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-Z>
|
|
.IP "<control-Z>"
|
|
Suspend the current editor session.
|
|
If the file has been modified since it was last completely written,
|
|
and the
|
|
.OP autowrite
|
|
option is set, the file is written before the editor session is
|
|
suspended.
|
|
If this write fails, the editor session is not suspended.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Unchanged.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP autowrite
|
|
option.
|
|
.SE
|
|
.KY <escape>
|
|
.IP "<escape>"
|
|
Execute
|
|
.CO ex
|
|
commands or cancel partial commands.
|
|
If an
|
|
.CO ex
|
|
command is being entered (e.g.
|
|
.CO / ,
|
|
.CO ? ,
|
|
.CO :
|
|
or
|
|
.CO ! ),
|
|
the command is executed.
|
|
If a partial command has been entered, e.g.
|
|
.QT "[0-9]*" ,
|
|
or
|
|
.QT "[0-9]*[!<>cdy]" ,
|
|
the command is cancelled.
|
|
Otherwise, it is an error.
|
|
.SS
|
|
.SP Line:
|
|
When an
|
|
.CO ex
|
|
command is being executed, the current line is set as described for
|
|
that command.
|
|
Otherwise, unchanged.
|
|
.SP Column:
|
|
When an
|
|
.CO ex
|
|
command is being executed, the current column is set as described for
|
|
that command.
|
|
Otherwise, unchanged.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <control-]>
|
|
.IP "<control-]>"
|
|
Push a tag reference onto the tag stack.
|
|
The tags files (see the
|
|
.OP tags
|
|
option for more information) are searched for a tag matching the
|
|
current word.
|
|
The current word begins at the first non-whitespace character on or
|
|
after the current cursor position,
|
|
and extends up to the next non-word character or the end of the line.
|
|
If a matching tag is found, the current file is discarded and the
|
|
file containing the tag reference is edited.
|
|
.sp
|
|
If the current file has been modified since it was last completely
|
|
written, the command will fail.
|
|
The
|
|
.CO <control-]>
|
|
command is an absolute movement.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the matching tag string.
|
|
.SP Column:
|
|
Set to the start of the matching tag string.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP tags
|
|
and
|
|
.OP taglength
|
|
options.
|
|
.SE
|
|
.KY <control-^>
|
|
.IP "<control-^>"
|
|
Switch to the most recently edited file.
|
|
.sp
|
|
If the file has been modified since it was last completely written,
|
|
and the
|
|
.OP autowrite
|
|
option is set, the file is written out.
|
|
If this write fails, the command will fail.
|
|
Otherwise, if the current file has been modified since it was last
|
|
completely written, the command will fail.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line the cursor was on when the file was last edited.
|
|
.SP Column:
|
|
Set to the column the cursor was on when the file was last edited.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP autowrite
|
|
option.
|
|
.SE
|
|
.KY <space>
|
|
.IP "[count] <space>"
|
|
.KY l
|
|
.Ip "[count] l"
|
|
Move the cursor forward
|
|
.LI count
|
|
characters without changing the current line.
|
|
It is an error if the cursor is on the last character in the line.
|
|
.sp
|
|
The
|
|
.CO <space>
|
|
and
|
|
.CO \&l
|
|
commands may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
In addition, these commands may be used as the motion components
|
|
of other commands when the cursor is on the last character in the
|
|
line, without error.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the current character plus the next
|
|
.LI count
|
|
characters, or to the last character on the line if
|
|
.LI count
|
|
is greater than the number of characters in the line after the
|
|
current character.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY !
|
|
.IP "[count] ! motion shell-argument(s)<carriage-return>"
|
|
Replace text with results from a shell command.
|
|
Pass the lines specified by the
|
|
.LI count
|
|
and
|
|
.LI motion
|
|
arguments as standard input to the program named by the
|
|
.OP shell
|
|
option, and replace those lines with the output (both
|
|
standard error and standard output) of that command.
|
|
.sp
|
|
After the motion is entered,
|
|
.CO vi
|
|
prompts for arguments to the shell command.
|
|
.sp
|
|
Within those arguments,
|
|
.QT %
|
|
and
|
|
.QT #
|
|
characters are expanded to the current and alternate pathnames,
|
|
respectively.
|
|
The
|
|
.QT !
|
|
character is expanded with the command text of the previous
|
|
.CO !
|
|
or
|
|
.CO :!
|
|
commands.
|
|
(Therefore, the command
|
|
.CO !<motion>!
|
|
repeats the previous
|
|
.CO !
|
|
command.)
|
|
The special meanings of
|
|
.QT % ,
|
|
.QT #
|
|
and
|
|
.QT !
|
|
can be overridden by escaping them with a backslash.
|
|
If no
|
|
.CO !
|
|
or
|
|
.CO :!
|
|
command has yet been executed,
|
|
it is an error to use an unescaped
|
|
.QT !
|
|
character as a shell argument.
|
|
The
|
|
.CO !
|
|
command does
|
|
.i not
|
|
do shell expansion on the strings provided as arguments.
|
|
If any of the above expansions change the arguments the user entered,
|
|
the command is redisplayed at the bottom of the screen.
|
|
.sp
|
|
.CO Vi
|
|
then executes the program named by the
|
|
.OP shell
|
|
option, with a
|
|
.b \-c
|
|
flag followed by the arguments (which are bundled into a single argument).
|
|
.sp
|
|
The
|
|
.CO !
|
|
command is permitted in an empty file.
|
|
.sp
|
|
If the file has been modified since it was last completely written,
|
|
the
|
|
.CO !
|
|
command will warn you.
|
|
.SS
|
|
.SP Line:
|
|
The first line of the replaced text.
|
|
.SP Column:
|
|
The first column of the replaced text.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP shell
|
|
option.
|
|
.SE
|
|
.KY #
|
|
.IP "[count] # #|+|-"
|
|
Increment or decrement the number referenced by the cursor.
|
|
If the trailing character is a
|
|
.LI \&+
|
|
or
|
|
.LI \&# ,
|
|
the number is incremented by
|
|
.LI count .
|
|
If the trailing character is a
|
|
.LI \&- ,
|
|
the number is decremented by
|
|
.LI count .
|
|
.sp
|
|
A leading
|
|
.QT \&0X
|
|
or
|
|
.QT \&0x
|
|
causes the number to be interpreted as a hexadecimal number.
|
|
Otherwise, a leading
|
|
.QT \&0
|
|
causes the number to be interpreted as an octal number, unless a non-octal
|
|
digit is found as part of the number.
|
|
Otherwise, the number is interpreted as a decimal number, and may
|
|
have a leading
|
|
.LI \&+
|
|
or
|
|
.LI \&-
|
|
sign.
|
|
The current number begins at the first non-blank character at or after
|
|
the current cursor position, and extends up to the end of the line or
|
|
the first character that isn't a possible character for the numeric type.
|
|
The format of the number (e.g. leading 0's, signs) is retained unless
|
|
the new value cannot be represented in the previous format.
|
|
.sp
|
|
Octal and hexadecimal numbers, and the result of the operation, must fit
|
|
into an
|
|
.QT "unsigned long" .
|
|
Similarly, decimal numbers and their result must fit into a
|
|
.QT "signed long" .
|
|
It is an error to use this command when the cursor is not positioned at
|
|
a number.
|
|
.sp
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the first character in the cursor number.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY $
|
|
.IP "[count] $"
|
|
Move the cursor to the end of a line.
|
|
If
|
|
.LI count
|
|
is specified, the cursor moves down
|
|
.LI "count - 1"
|
|
lines.
|
|
.sp
|
|
It is not an error to use the
|
|
.CO $
|
|
command when the cursor is on the last character in the line or
|
|
when the line is empty.
|
|
.sp
|
|
The
|
|
.CO $
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented, unless the cursor is at, or before the first
|
|
nonblank character in the line, in which case it is line oriented.
|
|
It is not an error to use the
|
|
.CO $
|
|
command as a motion component when the cursor is on the last character
|
|
in the line, although it is an error when the line is empty.
|
|
.SS
|
|
.SP Line:
|
|
Set to the current line plus
|
|
.LI count
|
|
minus 1.
|
|
.SP Column:
|
|
Set to the last character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY %
|
|
.IP %
|
|
Move to the matching character.
|
|
The cursor moves to the bracket character that
|
|
.i matches
|
|
the bracket found at the current cursor position
|
|
or which is the closest one to the right of the cursor on the line.
|
|
The bracket characters are defined by the
|
|
.OP matchchars
|
|
option.
|
|
An error will be reported if none of the
|
|
.OP matchchars
|
|
characters is found, or if no matching character is found.
|
|
If the open and close brackes are identical (e.g.: if they are
|
|
.QT '
|
|
or
|
|
.QT " ),
|
|
then repeating a
|
|
.CO %
|
|
command will perform a backwards search from the original opening bracket.
|
|
Historically, any
|
|
.LI count
|
|
specified to the
|
|
.CO %
|
|
command was ignored.
|
|
.sp
|
|
The
|
|
.CO %
|
|
command is an absolute movement.
|
|
The
|
|
.CO %
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented, unless the starting point of the region is at
|
|
or before the first nonblank character on its line, and the ending
|
|
point is at or after the last nonblank character on its line, in
|
|
which case it is line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the matching character.
|
|
.SP Column:
|
|
Set to the matching character.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY &
|
|
.IP "&"
|
|
Repeat the previous substitution command on the current line.
|
|
.sp
|
|
Historically, any
|
|
.LI count
|
|
specified to the
|
|
.CO &
|
|
command was ignored.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Unchanged if the cursor was on the last character in the line,
|
|
otherwise, set to the first nonblank character in the line.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP edcompatible ,
|
|
.OP extended ,
|
|
.OP ignorecase
|
|
and
|
|
.OP magic
|
|
options.
|
|
.SE
|
|
.KY SQUOTE<character>
|
|
.IP \'<character>
|
|
.KY `<character>
|
|
.Ip `<character>
|
|
Return to a context marked by the character
|
|
.LI <character> .
|
|
If
|
|
.LI <character>
|
|
is the
|
|
.QT '
|
|
or
|
|
.QT `
|
|
character, return to the previous context.
|
|
If
|
|
.LI <character>
|
|
is any other character,
|
|
return to the context marked by that character (see the
|
|
.CO m
|
|
command for more information).
|
|
If the command is the
|
|
.CO \'
|
|
command, only the line value is restored,
|
|
and the cursor is placed on the first nonblank character of that line.
|
|
If the command is the
|
|
.CO `
|
|
command, both the line and column values are restored.
|
|
.sp
|
|
It is an error if the context no longer exists because of
|
|
line deletion.
|
|
(Contexts follow lines that are moved, or which are deleted
|
|
and then restored.)
|
|
.sp
|
|
The
|
|
.CO \'
|
|
and
|
|
.CO `
|
|
commands are both absolute movements.
|
|
They may be used as a motion component for other
|
|
.CO vi
|
|
commands.
|
|
For the
|
|
.CO \'
|
|
command, any text copied into a buffer is line oriented.
|
|
For the
|
|
.CO `
|
|
command,
|
|
any text copied into a buffer is character oriented,
|
|
unless it both starts and stops at the first character in the line,
|
|
in which case it is line oriented.
|
|
In addition, when using the
|
|
.CO `
|
|
command as a motion component,
|
|
commands which move backward and started at the first character in the line,
|
|
or move forward and ended at the first character in the line,
|
|
are corrected to the last character of the line preceding the starting and
|
|
ending lines, respectively.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line from the context.
|
|
.SP Column:
|
|
Set to the first nonblank character in the line, for the
|
|
.CO \'
|
|
command, and set to the context's column for the
|
|
.CO `
|
|
command.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY (
|
|
.IP "[count] ("
|
|
Back up
|
|
.LI count
|
|
sentences.
|
|
.sp
|
|
The
|
|
.CO (
|
|
command is an absolute movement.
|
|
The
|
|
.CO (
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands,
|
|
in which case any text copied into a buffer is character oriented,
|
|
unless the starting and stopping points of the region are the first
|
|
character in the line,
|
|
in which case it is line oriented.
|
|
If it is line oriented,
|
|
the starting point of the region is adjusted to be the end of the line
|
|
immediately before the starting cursor position.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the beginning of the sentence.
|
|
.SP Column:
|
|
Set to the first nonblank character of the sentence.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP lisp
|
|
option.
|
|
.SE
|
|
.KY )
|
|
.IP "[count] )"
|
|
Move forward
|
|
.LI count
|
|
sentences.
|
|
.sp
|
|
The
|
|
.CO )
|
|
command is an absolute movement.
|
|
The
|
|
.CO )
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented, unless the starting point of the region is the
|
|
first character in the line, in which case it is line oriented.
|
|
In the latter case, if the stopping point of the region is also
|
|
the first character in the line, it is adjusted to be the end of the
|
|
line immediately before it.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the beginning of the sentence.
|
|
.SP Column:
|
|
Set to the first nonblank character of the sentence.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP lisp
|
|
option.
|
|
.SE
|
|
.KY ,
|
|
.IP "[count] ,"
|
|
Reverse find character
|
|
.LI count
|
|
times.
|
|
Reverse the last
|
|
.CO F ,
|
|
.CO f ,
|
|
.CO T
|
|
or
|
|
.CO t
|
|
command, searching the other way in the line,
|
|
.LI count
|
|
times.
|
|
It is an error if a
|
|
.CO F ,
|
|
.CO f ,
|
|
.CO T
|
|
or
|
|
.CO t
|
|
command has not been performed yet.
|
|
.sp
|
|
The
|
|
.CO ,
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the searched-for character for the
|
|
.CO F
|
|
and
|
|
.CO f
|
|
commands,
|
|
before the character for the
|
|
.CO t
|
|
command
|
|
and after the character for the
|
|
.CO T
|
|
command.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY MINUSSIGN
|
|
.IP "[count] \-"
|
|
Move to the first nonblank of the previous line,
|
|
.LI count
|
|
times.
|
|
.sp
|
|
It is an error if the movement is past the beginning of the file.
|
|
.sp
|
|
The
|
|
.CO -
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the current line minus
|
|
.LI count .
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY \&.
|
|
.IP "[count] \&."
|
|
Repeat the last
|
|
.CO vi
|
|
command that modified text.
|
|
The repeated command may be a command and motion component combination.
|
|
If
|
|
.LI count
|
|
is specified, it replaces
|
|
.i both
|
|
the count specified for the repeated command, and, if applicable, for
|
|
the repeated motion component.
|
|
If
|
|
.LI count
|
|
is not specified, the counts originally specified to the command being
|
|
repeated are used again.
|
|
.sp
|
|
As a special case, if the
|
|
.CO \.
|
|
command is executed immediately after the
|
|
.CO u
|
|
command, the change log is rolled forward or backward, depending on
|
|
the action of the
|
|
.CO u
|
|
command.
|
|
.SS
|
|
.SP Line:
|
|
Set as described for the repeated command.
|
|
.SP Column:
|
|
Set as described for the repeated command.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY /RE/
|
|
.IP "/RE<carriage-return>"
|
|
.Ip "/RE/ [offset]<carriage-return>"
|
|
.KY ?RE?
|
|
.Ip "?RE<carriage-return>"
|
|
.Ip "?RE? [offset]<carriage-return>"
|
|
.KY N
|
|
.Ip "N"
|
|
.KY n
|
|
.Ip "n"
|
|
Search forward or backward for a regular expression.
|
|
The commands beginning with a slash
|
|
.PQ /
|
|
character are forward searches, the commands beginning with a
|
|
question mark
|
|
.PQ ?
|
|
are backward searches.
|
|
.CO Vi
|
|
prompts with the leading character on the last line of the screen
|
|
for a string.
|
|
It then searches forward or backward in the file for the next
|
|
occurrence of the string, which is interpreted as a Basic Regular
|
|
Expression.
|
|
.sp
|
|
The
|
|
.CO /
|
|
and
|
|
.CO ?
|
|
commands are absolute movements.
|
|
They may be used as the motion components of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented, unless the search started and ended on
|
|
the first column of a line, in which case it is line oriented.
|
|
In addition, forward searches ending at the first character of a line,
|
|
and backward searches beginning at the first character in the line,
|
|
are corrected to begin or end at the last character of the previous line.
|
|
(Note, forward and backward searches can occur for both
|
|
.CO /
|
|
and
|
|
.CO ?
|
|
commands, if the
|
|
.OP wrapscan
|
|
option is set.)
|
|
.sp
|
|
If an offset from the matched line is specified (i.e. a trailing
|
|
.QT /
|
|
or
|
|
.QT ?
|
|
character is followed by a signed offset), the buffer will always
|
|
be line oriented (e.g.
|
|
.QT /string/+0
|
|
will always guarantee a line orientation).
|
|
.sp
|
|
The
|
|
.CO N
|
|
command repeats the previous search, but in the reverse direction.
|
|
The
|
|
.CO n
|
|
command repeats the previous search.
|
|
If either the
|
|
.CO N
|
|
or
|
|
.CO n
|
|
commands are used as motion components for the
|
|
.CO !
|
|
command, you will not be prompted for the text of the bang command,
|
|
instead the previous bang command will be executed.
|
|
.sp
|
|
Missing RE's (e.g.
|
|
.QT //<carriage-return> ,
|
|
.QT /<carriage-return> ,
|
|
.QT ??<carriage-return> ,
|
|
or
|
|
.QT ?<carriage-return>
|
|
search for the last search RE, in the indicated direction.
|
|
.sp
|
|
Searches may be interrupted using the
|
|
.LI <interrupt>
|
|
character.
|
|
.sp
|
|
Multiple search patterns may be grouped together by delimiting
|
|
them with semicolons and zero or more whitespace characters, e.g.
|
|
.LI "/foo/ ; ?bar?"
|
|
searches forward for
|
|
.LI foo
|
|
and then, from that location, backwards for
|
|
.LI bar .
|
|
When search patterns are grouped together in this manner,
|
|
the search patterns are evaluated left to right with the
|
|
final cursor position determined by the last search pattern.
|
|
.sp
|
|
It is also permissible to append a
|
|
.CO z
|
|
command to the search strings, e.g.
|
|
.LI "/foo/ z."
|
|
searches forward for the next occurrence of
|
|
.LI foo ,
|
|
and then positions that line in the middle of screen.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line in which the match occurred.
|
|
.SP Column:
|
|
Set to the first character of the matched string.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP edcompatible ,
|
|
.OP extended ,
|
|
.OP ignorecase ,
|
|
.OP magic ,
|
|
and
|
|
.OP wrapscan
|
|
options.
|
|
.SE
|
|
.KY 0
|
|
.IP "0"
|
|
Move to the first character in the current line.
|
|
It is not an error to use the
|
|
.CO 0
|
|
command when the cursor is on the first character in the line,
|
|
.sp
|
|
The
|
|
.CO 0
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands,
|
|
in which case it is an error if the cursor is on the first character
|
|
in the line,
|
|
and any text copied into a buffer is character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the first character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY :
|
|
.IP ":"
|
|
Execute an
|
|
.CO ex
|
|
command.
|
|
.CO Vi
|
|
prompts for an
|
|
.CO ex
|
|
command on the last line of the screen, using a colon
|
|
.PQ :
|
|
character.
|
|
The command is terminated by a
|
|
.LI <carriage-return> ,
|
|
.LI <newline>
|
|
or
|
|
.LI <escape>
|
|
character; all of these characters may be escaped by using a
|
|
.LI "<literal-next>"
|
|
character.
|
|
The command is then executed.
|
|
.sp
|
|
If the
|
|
.CO ex
|
|
command writes to the screen,
|
|
.CO vi
|
|
will prompt the user for a
|
|
.LI <carriage-return>
|
|
before continuing
|
|
when the
|
|
.CO ex
|
|
command finishes.
|
|
Large amounts of output from the
|
|
.CO ex
|
|
command will be paged for the user, and the user prompted for a
|
|
.LI <carriage-return>
|
|
or
|
|
.LI <space>
|
|
key to continue.
|
|
In some cases, a quit (normally a
|
|
.QQ q
|
|
character) or
|
|
.LI <interrupt>
|
|
may be entered to interrupt the
|
|
.CO ex
|
|
command.
|
|
.sp
|
|
When the
|
|
.CO ex
|
|
command finishes, and the user is prompted to resume visual mode,
|
|
it is also possible to enter another
|
|
.QT :
|
|
character followed by another
|
|
.CO ex
|
|
command.
|
|
.SS
|
|
.SP Line:
|
|
The current line is set as described for the
|
|
.CO ex
|
|
command.
|
|
.SP Column:
|
|
The current column is set as described for the
|
|
.CO ex
|
|
command.
|
|
.SP Options:
|
|
Affected as described for the
|
|
.CO ex
|
|
command.
|
|
.SE
|
|
.KY ;
|
|
.IP "[count] ;"
|
|
Repeat the last character find
|
|
.LI count
|
|
times.
|
|
The last character find is one of the
|
|
.CO F ,
|
|
.CO f ,
|
|
.CO T
|
|
or
|
|
.CO t
|
|
commands.
|
|
It is an error if a
|
|
.CO F ,
|
|
.CO f ,
|
|
.CO T
|
|
or
|
|
.CO t
|
|
command has not been performed yet.
|
|
.sp
|
|
The
|
|
.CO ;
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the searched-for character for the
|
|
.CO F
|
|
and
|
|
.CO f
|
|
commands,
|
|
before the character for the
|
|
.CO t
|
|
command
|
|
and after the character for the
|
|
.CO T
|
|
command.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY <
|
|
.IP "[count] < motion"
|
|
.KY >
|
|
.Ip "[count] > motion"
|
|
Shift lines left or right.
|
|
Shift the number of lines in the region specified by the
|
|
.LI count
|
|
and
|
|
.LI motion
|
|
left (for the
|
|
.CO <
|
|
command) or right (for the
|
|
.CO >
|
|
command) by the number of columns specified by the
|
|
.OP shiftwidth
|
|
option.
|
|
Only whitespace characters are deleted when shifting left.
|
|
Once the first character in the line no longer contains a whitespace
|
|
character, the command will succeed,
|
|
but the line will not be modified.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP shiftwidth
|
|
option.
|
|
.SE
|
|
.KY @
|
|
.IP "@ buffer"
|
|
Execute a named buffer.
|
|
Execute the named buffer as
|
|
.CO vi
|
|
commands.
|
|
The buffer may include
|
|
.CO ex
|
|
commands, too, but they must be expressed as a
|
|
.CO :
|
|
command.
|
|
If the buffer is line oriented,
|
|
.LI <newline>
|
|
characters are logically appended to each line of the buffer.
|
|
If the buffer is character oriented,
|
|
.LI <newline>
|
|
characters are logically appended to all but the last line in the buffer.
|
|
.sp
|
|
If the buffer name is
|
|
.QT @ ,
|
|
or
|
|
.QT * ,
|
|
then the last buffer executed shall be used.
|
|
It is an error to specify
|
|
.QT @@
|
|
or
|
|
.QT @*
|
|
if there were no previous buffer executions.
|
|
The text of a buffer may contain a
|
|
.CO @
|
|
command,
|
|
and it is possible to create infinite loops in this manner.
|
|
(The
|
|
.LI <interrupt>
|
|
character may be used to interrupt the loop.)
|
|
.SS
|
|
.SP Line:
|
|
The current line is set as described for the command(s).
|
|
.SP Column:
|
|
The current column is set as described for the command(s).
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY A
|
|
.IP "[count] A"
|
|
Enter input mode, appending the text after the end of the line.
|
|
If
|
|
.LI count
|
|
is specified, the text is repeatedly input
|
|
.LI "count - 1"
|
|
more times after input mode is exited.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY B
|
|
.IP "[count] B"
|
|
Move backward
|
|
.LI count
|
|
bigwords.
|
|
Move the cursor backward to the beginning of a bigword by repeating the
|
|
following algorithm: if the current position is at the beginning of a
|
|
bigword or the character at the current position cannot be part of a bigword,
|
|
move to the first character of the preceding bigword.
|
|
Otherwise, move to the first character of the bigword at the current position.
|
|
If no preceding bigword exists on the current line, move to the first
|
|
character of the last bigword on the first preceding line that contains a
|
|
bigword.
|
|
.sp
|
|
The
|
|
.CO B
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the word selected.
|
|
.SP Column:
|
|
Set to the first character of the word selected.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY C
|
|
.IP "[buffer] [count] C"
|
|
Change text from the current position to the end-of-line.
|
|
If
|
|
.LI count
|
|
is specified, the input text replaces from the current position to
|
|
the end-of-line, plus
|
|
.LI "count - 1"
|
|
subsequent lines.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY D
|
|
.IP "[buffer] D"
|
|
Delete text from the current position to the end-of-line.
|
|
.sp
|
|
It is not an error to execute the
|
|
.CO D
|
|
command on an empty line.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the character before the current character, or, column 1 if
|
|
the cursor was on column 1.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY E
|
|
.IP "[count] E"
|
|
Move forward
|
|
.LI count
|
|
end-of-bigwords.
|
|
Move the cursor forward to the end of a bigword by repeating the
|
|
following algorithm: if the current position is the end of a
|
|
bigword or the character at that position cannot be part of a bigword,
|
|
move to the last character of the following bigword.
|
|
Otherwise, move to the last character of the bigword at the current
|
|
position.
|
|
If no succeeding bigword exists on the current line,
|
|
move to the last character of the first bigword on the next following
|
|
line that contains a bigword.
|
|
.sp
|
|
The
|
|
.CO E
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the word selected.
|
|
.SP Column:
|
|
Set to the last character of the word selected.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY F
|
|
.IP "[count] F <character>"
|
|
Search
|
|
.LI count
|
|
times backward through the current line for
|
|
.LI <character> .
|
|
.sp
|
|
The
|
|
.CO F
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the searched-for character.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY G
|
|
.IP "[count] G"
|
|
Move to line
|
|
.LI count ,
|
|
or the last line of the file if
|
|
.LI count
|
|
not specified.
|
|
.sp
|
|
The
|
|
.CO G
|
|
command is an absolute movement.
|
|
The
|
|
.CO \&G
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to
|
|
.LI count ,
|
|
if specified, otherwise, the last line.
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY H
|
|
.IP "[count] H"
|
|
Move to the screen line
|
|
.LI "count - 1"
|
|
lines below the top of the screen.
|
|
.sp
|
|
The
|
|
.CO H
|
|
command is an absolute movement.
|
|
The
|
|
.CO H
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line
|
|
.LI "count - 1"
|
|
lines below the top of the screen.
|
|
.SP Column:
|
|
Set to the first nonblank character of the
|
|
.i screen
|
|
line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY I
|
|
.IP "[count] I"
|
|
Enter input mode, inserting the text at the beginning of the line.
|
|
If
|
|
.LI count
|
|
is specified, the text input is repeatedly input
|
|
.LI "count - 1"
|
|
more times.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY J
|
|
.IP "[count] J"
|
|
Join lines.
|
|
If
|
|
.LI count
|
|
is specified,
|
|
.LI count
|
|
lines are joined; a minimum of two lines are always joined,
|
|
regardless of the value of
|
|
.LI count .
|
|
.sp
|
|
If the current line ends with a whitespace character, all whitespace
|
|
is stripped from the next line.
|
|
Otherwise, if the next line starts with a open parenthesis
|
|
.PQ (
|
|
do nothing.
|
|
Otherwise, if the current line ends with a question mark
|
|
.PQ ? ,
|
|
period
|
|
.PQ \&.
|
|
or exclamation point
|
|
.PQ ! ,
|
|
insert two spaces.
|
|
Otherwise, insert a single space.
|
|
.sp
|
|
It is not an error to join lines past the end of the file,
|
|
i.e. lines that do not exist.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the character after the last character of the next-to-last
|
|
joined line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY L
|
|
.IP "[count] L"
|
|
Move to the screen line
|
|
.LI "count - 1"
|
|
lines above the bottom of the screen.
|
|
.sp
|
|
The
|
|
.CO L
|
|
command is an absolute movement.
|
|
The
|
|
.CO L
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line
|
|
.LI "count - 1"
|
|
lines above the bottom of the screen.
|
|
.SP Column:
|
|
Set to the first nonblank character of the
|
|
.i screen
|
|
line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY M
|
|
.IP " M"
|
|
Move to the screen line in the middle of the screen.
|
|
.sp
|
|
The
|
|
.CO M
|
|
command is an absolute movement.
|
|
The
|
|
.CO M
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
line oriented.
|
|
.sp
|
|
Historically, any
|
|
.LI count
|
|
specified to the
|
|
.CO M
|
|
command was ignored.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line in the middle of the screen.
|
|
.SP Column:
|
|
Set to the first nonblank character of the
|
|
.i screen
|
|
line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY O
|
|
.IP "[count] O"
|
|
Enter input mode, appending text in a new line above the current line.
|
|
If
|
|
.LI count
|
|
is specified, the text input is repeatedly input
|
|
.LI "count - 1"
|
|
more times.
|
|
.sp
|
|
Historically, any
|
|
.LI count
|
|
specified to the
|
|
.CO O
|
|
command was ignored.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY P
|
|
.IP "[buffer] P"
|
|
Insert text from a buffer.
|
|
Text from the buffer (the unnamed buffer by default) is inserted
|
|
before the current column or, if the buffer is line oriented,
|
|
before the current line.
|
|
.SS
|
|
.SP Line:
|
|
Set to the lowest numbered line insert,
|
|
if the buffer is line oriented, otherwise unchanged.
|
|
.SP Column:
|
|
Set to the first nonblank character of the appended text,
|
|
if the buffer is line oriented, otherwise, the last character
|
|
of the appended text.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY Q
|
|
.IP "Q"
|
|
Exit
|
|
.CO vi
|
|
(or visual) mode and switch to
|
|
.CO ex
|
|
mode.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
No longer relevant.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY R
|
|
.IP "[count] R"
|
|
Enter input mode, replacing the characters in the current line.
|
|
If
|
|
.LI count
|
|
is specified, the text input is repeatedly input
|
|
.LI "count - 1"
|
|
more times.
|
|
.sp
|
|
If the end of the current line is reached, no more characters are
|
|
replaced and any further characters input are appended to the line.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY S
|
|
.IP "[buffer] [count] S"
|
|
Substitute
|
|
.LI count
|
|
lines.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY T
|
|
.IP "[count] T <character>"
|
|
Search backward,
|
|
.LI count
|
|
times,
|
|
through the current line for the character
|
|
.i after
|
|
the specified
|
|
.LI <character> .
|
|
.sp
|
|
The
|
|
.CO T
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the character
|
|
.i after
|
|
the searched-for character.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY U
|
|
.IP "U"
|
|
Restore the current line to its state before the cursor last
|
|
moved to it.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
The first character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY W
|
|
.IP "[count] W"
|
|
Move forward
|
|
.LI count
|
|
bigwords.
|
|
Move the cursor forward to the beginning of a bigword by repeating the
|
|
following algorithm: if the current position is within a bigword or the
|
|
character at that position cannot be part of a bigword, move to the first
|
|
character of the next bigword.
|
|
If no subsequent bigword exists on the current line,
|
|
move to the first character of the first bigword on the first following
|
|
line that contains a bigword.
|
|
.sp
|
|
The
|
|
.CO W
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
The line containing the word selected.
|
|
.SP Column:
|
|
The first character of the word selected.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY X
|
|
.IP "[buffer] [count] X"
|
|
Delete
|
|
.LI count
|
|
characters before the cursor.
|
|
If the number of characters to be deleted is greater than or equal to
|
|
the number of characters to the beginning of the line, all of the
|
|
characters before the current cursor position, to the beginning of the
|
|
line, are deleted.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the current character minus
|
|
.LI count ,
|
|
or the first character if count is greater than the number of
|
|
characters in the line before the cursor.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY Y
|
|
.IP "[buffer] [count] Y"
|
|
Copy (or
|
|
.QQ yank )
|
|
.LI count
|
|
lines into the specified buffer.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Unchanged.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY ZZ
|
|
.IP "ZZ"
|
|
Write the file and exit
|
|
.CO vi .
|
|
The file is only written if it has been modified since the last
|
|
complete write of the file to any file.
|
|
.sp
|
|
The
|
|
.CO ZZ
|
|
command will exit the editor after writing the file,
|
|
if there are no further files to edit.
|
|
Entering two
|
|
.QQ quit
|
|
commands (i.e.
|
|
.CO wq ,
|
|
.CO quit ,
|
|
.CO xit
|
|
or
|
|
.CO ZZ )
|
|
in a row will override this check and the editor will exit,
|
|
ignoring any files that have not yet been edited.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Unchanged.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY [[
|
|
.IP "[count] [["
|
|
Back up
|
|
.LI count
|
|
section boundaries.
|
|
.sp
|
|
The
|
|
.CO [[
|
|
command is an absolute movement.
|
|
The
|
|
.CO [[
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented, unless the starting position is column 0,
|
|
in which case it is line oriented.
|
|
.sp
|
|
It is an error if the movement is past the beginning of the file.
|
|
.SS
|
|
.SP Line:
|
|
Set to the previous line that is
|
|
.LI count
|
|
section boundaries back,
|
|
or the first line of the file if no more section boundaries exist
|
|
preceding the current line.
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP sections
|
|
option.
|
|
.SE
|
|
.KY ]]
|
|
.IP "[count] ]]"
|
|
Move forward
|
|
.LI count
|
|
section boundaries.
|
|
.sp
|
|
The
|
|
.CO ]]
|
|
command is an absolute movement.
|
|
The
|
|
.CO ]]
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented, unless the starting position is column 0,
|
|
in which case it is line oriented.
|
|
.sp
|
|
It is an error if the movement is past the end of the file.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line that is
|
|
.LI count
|
|
section boundaries forward,
|
|
or to the last line of the file if no more section
|
|
boundaries exist following the current line.
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP sections
|
|
option.
|
|
.SE
|
|
.KY ^
|
|
.IP "\&^"
|
|
Move to first nonblank character on the current line.
|
|
.sp
|
|
The
|
|
.CO ^
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the first nonblank character of the current line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY _
|
|
.IP "[count] _"
|
|
Move down
|
|
.LI "count - 1"
|
|
lines, to the first nonblank character.
|
|
The
|
|
.CO _
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
line oriented.
|
|
.sp
|
|
It is not an error to execute the
|
|
.CO _
|
|
command when the cursor is on the first character in the line.
|
|
.SS
|
|
.SP Line:
|
|
The current line plus
|
|
.LI "count - 1" .
|
|
.SP Column:
|
|
The first nonblank character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY a
|
|
.IP "[count] a"
|
|
Enter input mode, appending the text after the cursor.
|
|
If
|
|
.LI count
|
|
is specified, the text input is repeatedly input
|
|
.LI "count - 1"
|
|
more times.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY b
|
|
.IP "[count] b"
|
|
Move backward
|
|
.LI count
|
|
words.
|
|
Move the cursor backward to the beginning of a word by repeating the
|
|
following algorithm: if the current position is at the beginning of a word,
|
|
move to the first character of the preceding word.
|
|
Otherwise, the current position moves to the first character of the word
|
|
at the current position.
|
|
If no preceding word exists on the current line, move to the first
|
|
character of the last word on the first preceding line that contains
|
|
a word.
|
|
.sp
|
|
The
|
|
.CO b
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the word selected.
|
|
.SP Column:
|
|
Set to the first character of the word selected.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY c
|
|
.IP "[buffer] [count] c motion"
|
|
Change the region of text specified by the
|
|
.LI count
|
|
and
|
|
.LI motion .
|
|
If only part of a single line is affected, then the last character
|
|
being changed is marked with a
|
|
.QT $ .
|
|
Otherwise, the region of text is deleted, and input mode is entered.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY d
|
|
.IP "[buffer] [count] d motion"
|
|
Delete the region of text specified by the
|
|
.LI count
|
|
and
|
|
.LI motion .
|
|
.SS
|
|
.SP Line:
|
|
Set to the line where the region starts.
|
|
.SP Column:
|
|
Set to the first character in the line after the last character in the
|
|
region.
|
|
If no such character exists, set to the last character before the region.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY e
|
|
.IP "[count] e"
|
|
Move forward
|
|
.LI count
|
|
end-of-words.
|
|
Move the cursor forward to the end of a word by repeating the following
|
|
algorithm: if the current position is the end of a word,
|
|
move to the last character of the following word.
|
|
Otherwise, move to the last character of the word at the current position.
|
|
If no succeeding word exists on the current line, move to the last character
|
|
of the first word on the next following line that contains a word.
|
|
.sp
|
|
The
|
|
.CO e
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the word selected.
|
|
.SP Column:
|
|
Set to the last character of the word selected.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY f
|
|
.IP "[count] f <character>"
|
|
Search forward,
|
|
.LI count
|
|
times, through the rest of the current line for
|
|
.LI <character> .
|
|
.sp
|
|
The
|
|
.CO f
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the searched-for character.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY i
|
|
.IP "[count] i"
|
|
Enter input mode, inserting the text before the cursor.
|
|
If
|
|
.LI count
|
|
is specified, the text input is repeatedly input
|
|
.LI "count - 1"
|
|
more times.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY m
|
|
.IP "m <character>"
|
|
Save the current context (line and column) as
|
|
.LI <character> .
|
|
The exact position is referred to by
|
|
.QT `<character> .
|
|
The line is referred to by
|
|
.QT '<character> .
|
|
.sp
|
|
Historically,
|
|
.LI <character>
|
|
was restricted to lower-case letters.
|
|
.CO Nvi
|
|
permits the use of any character.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Unchanged.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY o
|
|
.IP "[count] o"
|
|
Enter input mode, appending text in a new line under the current line.
|
|
If
|
|
.LI count
|
|
is specified, the text input is repeatedly input
|
|
.LI "count - 1"
|
|
more times.
|
|
.sp
|
|
Historically, any
|
|
.LI count
|
|
specified to the
|
|
.CO o
|
|
command was ignored.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY p
|
|
.IP "[buffer] p"
|
|
Append text from a buffer.
|
|
Text from the buffer (the unnamed buffer by default) is appended
|
|
after the current column or, if the buffer is line oriented,
|
|
after the current line.
|
|
.SS
|
|
.SP Line:
|
|
Set to the first line appended, if the buffer is line oriented,
|
|
otherwise unchanged.
|
|
.SP Column:
|
|
Set to the first nonblank character of the appended text if the buffer
|
|
is line oriented, otherwise, the last character of the appended text.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY r
|
|
.IP "[count] r <character>"
|
|
Replace characters.
|
|
The next
|
|
.LI count
|
|
characters in the line are replaced with
|
|
.LI <character> .
|
|
Replacing characters with
|
|
.LI <newline>
|
|
characters results in creating new, empty lines into the file.
|
|
.sp
|
|
If
|
|
.LI <character>
|
|
is
|
|
.LI <escape> ,
|
|
the command is cancelled.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged unless the replacement character is a
|
|
.LI <newline> ,
|
|
in which case it is set to the current line plus
|
|
.LI "count - 1" .
|
|
.SP Column:
|
|
Set to the last character replaced,
|
|
unless the replacement character is a
|
|
.LI <newline> ,
|
|
in which case the cursor is in column 1 of the last line inserted.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY s
|
|
.IP "[buffer] [count] s"
|
|
Substitute
|
|
.LI count
|
|
characters in the current line starting with the current character.
|
|
.SS
|
|
.SP Line:
|
|
Set to the last line upon which characters were entered.
|
|
.SP Column:
|
|
Set to the last character entered.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP altwerase ,
|
|
.OP autoindent ,
|
|
.OP beautify ,
|
|
.OP showmatch ,
|
|
.OP ttywerase
|
|
and
|
|
.OP wrapmargin
|
|
options.
|
|
.SE
|
|
.KY t
|
|
.IP "[count] t <character>"
|
|
Search forward,
|
|
.LI count
|
|
times, through the current line for the character immediately
|
|
.i before
|
|
.LI <character> .
|
|
.sp
|
|
The
|
|
.CO t
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the character
|
|
.i before
|
|
the searched-for character.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY u
|
|
.IP "u"
|
|
Undo the last change made to the file.
|
|
If repeated, the
|
|
.CO u
|
|
command alternates between these two states, and is its own inverse.
|
|
When used after an insert that inserted text on more than one line,
|
|
the lines are saved in the numeric buffers.
|
|
.sp
|
|
The
|
|
.CO \&.
|
|
command, when used immediately after the
|
|
.CO u
|
|
command, causes the change log to be rolled forward or backward,
|
|
depending on the action of the
|
|
.CO u
|
|
command.
|
|
.SS
|
|
.SP Line:
|
|
Set to the position of the first line changed, if the reversal affects
|
|
only one line or represents an addition or change; otherwise, the line
|
|
preceding the deleted text.
|
|
.SP Column:
|
|
Set to the cursor position before the change was made.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY w
|
|
.IP "[count] w"
|
|
Move forward
|
|
.LI count
|
|
words.
|
|
Move the cursor forward to the beginning of a word by repeating the
|
|
following algorithm: if the current position is at the
|
|
beginning of a word, move to the first character of the next word.
|
|
If no subsequent word exists on the current line, move to the first
|
|
character of the first word on the first following line that contains
|
|
a word.
|
|
.sp
|
|
The
|
|
.CO w
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the word selected.
|
|
.SP Column:
|
|
Set to the first character of the word selected.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY x
|
|
.IP "[buffer] [count] x"
|
|
Delete
|
|
.LI count
|
|
characters.
|
|
The deletion is at the current character position.
|
|
If the number of characters to be deleted is greater than or equal to
|
|
the number of characters to the end of the line, all of the characters
|
|
from the current cursor position to the end of the line are deleted.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Unchanged unless the last character in the line is deleted and the cursor
|
|
is not already on the first character in the line, in which case it is
|
|
set to the previous character.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY y
|
|
.IP "[buffer] [count] y motion"
|
|
Copy (or
|
|
.QQ yank )
|
|
the text region specified by the
|
|
.LI count
|
|
and
|
|
.LI motion ,
|
|
into a buffer.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged, unless the region covers more than a single line,
|
|
in which case it is set to the line where the region starts.
|
|
.SP Column:
|
|
Unchanged, unless the region covers more than a single line,
|
|
in which case it is set to the character were the region starts.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY z
|
|
.IP "[count1] z [count2] type"
|
|
Redraw the screen with a window
|
|
.LI count2
|
|
lines long, with line
|
|
.LI count1
|
|
placed as specified by the
|
|
.LI type
|
|
character.
|
|
If
|
|
.LI count1
|
|
is not specified, it defaults to the current line.
|
|
If
|
|
.LI count2
|
|
is not specified, it defaults to the current window size.
|
|
.sp
|
|
The following
|
|
.LI type
|
|
characters may be used:
|
|
.SS
|
|
.SP +
|
|
If
|
|
.LI count1
|
|
is specified, place the line
|
|
.LI count1
|
|
at the top of the screen.
|
|
Otherwise, display the screen after the current screen, similarly to the
|
|
.CO <control-F>
|
|
command.
|
|
.SP <carriage-return>
|
|
Place the line
|
|
.LI count1
|
|
at the top of the screen.
|
|
.SP \&.
|
|
Place the line
|
|
.LI count1
|
|
in the center of the screen.
|
|
.SP \-
|
|
Place the line
|
|
.LI count1
|
|
at the bottom of the screen.
|
|
.SP ^
|
|
If
|
|
.LI count1
|
|
is specified, place the line that is at the top of the screen
|
|
when
|
|
.LI count1
|
|
is at the bottom of the screen, at the bottom of the screen,
|
|
i.e. display the screen before the screen before
|
|
.LI count1 .
|
|
Otherwise, display the screen before the current screen, similarly to the
|
|
.CO <control-B>
|
|
command.
|
|
.SE
|
|
.SS
|
|
.SP Line:
|
|
Set to
|
|
.LI count1
|
|
unless
|
|
.LI count1
|
|
is not specified and the
|
|
.LI type
|
|
character was either
|
|
.QT ^
|
|
or
|
|
.QT + ,
|
|
in which case it is set to the line before the first line on the
|
|
previous screen or the line after the last line on the previous
|
|
screen, respectively.
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY {
|
|
.IP "[count] {"
|
|
Move backward
|
|
.LI count
|
|
paragraphs.
|
|
.sp
|
|
The
|
|
.CO {
|
|
command is an absolute movement.
|
|
The
|
|
.CO {
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented, unless the starting character is the first
|
|
character on its line, in which case it is line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the beginning of the previous paragraph.
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP paragraph
|
|
option.
|
|
.SE
|
|
.KY |
|
|
.IP "[count] |"
|
|
Move to a specific
|
|
.i column
|
|
position on the current line.
|
|
.sp
|
|
The
|
|
.CO |
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented.
|
|
It is an error to use the
|
|
.CO |
|
|
command as a motion component and for the cursor not to move.
|
|
.SS
|
|
.SP Line:
|
|
Unchanged.
|
|
.SP Column:
|
|
Set to the character occupying the column position identified by
|
|
.LI count ,
|
|
if the position exists in the line.
|
|
If the column length of the current line is less than
|
|
.LI count ,
|
|
the cursor is moved to the last character in the line.
|
|
.SP Options:
|
|
None.
|
|
.SE
|
|
.KY }
|
|
.IP "[count] }"
|
|
Move forward
|
|
.LI count
|
|
paragraphs.
|
|
.sp
|
|
The
|
|
.CO }
|
|
command is an absolute movement.
|
|
The
|
|
.CO }
|
|
command may be used as the motion component of other
|
|
.CO vi
|
|
commands, in which case any text copied into a buffer is
|
|
character oriented, unless the starting character is at or
|
|
before any nonblank characters in its line,
|
|
in which case it is line oriented.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line containing the beginning of the next paragraph.
|
|
.SP Column:
|
|
Set to the first nonblank character in the line.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP paragraph
|
|
option.
|
|
.SE
|
|
.KY ~
|
|
.IP "[count] ~"
|
|
Reverse the case of the next
|
|
.LI count
|
|
character(s).
|
|
This is the historic semantic for the
|
|
.CO ~
|
|
command and it is only in effect if the
|
|
.OP tildeop
|
|
option is not set.
|
|
.sp
|
|
Lowercase alphabetic characters are changed to uppercase,
|
|
and uppercase characters are changed to lowercase.
|
|
No other characters are affected.
|
|
.sp
|
|
Historically, the
|
|
.CO ~
|
|
command did not take an associated count, nor did it move past the
|
|
end of the current line.
|
|
As it had no associated motion it was difficult to change the case
|
|
of large blocks of text.
|
|
In
|
|
.CO nvi ,
|
|
if the cursor is on the last character of a line, and there are
|
|
more lines in the file, the cursor moves to the next line.
|
|
.sp
|
|
It is not an error to specify a count larger than the number of
|
|
characters between the cursor and the end of the file.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line of the character after
|
|
.LI count
|
|
characters, or, end of file.
|
|
.SP Column:
|
|
Set to the character after
|
|
.LI count
|
|
characters, or, end-of-file.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP tildeop
|
|
option.
|
|
.SE
|
|
.KY ~
|
|
.IP "[count] ~ motion"
|
|
Reverse the case of the characters in a text region specified by the
|
|
.LI count
|
|
and
|
|
.LI motion .
|
|
Only in effect if the
|
|
.OP tildeop
|
|
option is set.
|
|
.sp
|
|
Lowercase characters are changed to uppercase,
|
|
and uppercase characters are changed to lowercase.
|
|
No other characters are affected.
|
|
.SS
|
|
.SP Line:
|
|
Set to the line of the character after the last character in the region.
|
|
.SP Column:
|
|
Set to the character after the last character in the region.
|
|
.SP Options:
|
|
Affected by the
|
|
.OP tildeop
|
|
option.
|
|
.SE
|
|
.KY <interrupt>
|
|
.IP "<interrupt>"
|
|
Interrupt the current operation.
|
|
Many of the potentially long-running
|
|
.CO vi
|
|
commands may be interrupted using the terminal interrupt character.
|
|
These operations include searches, file reading and writing, filter
|
|
operations and map character expansion.
|
|
Interrupts are also enabled when running commands outside of
|
|
.CO vi .
|
|
.sp
|
|
If the
|
|
.LI <interrupt>
|
|
character is used to interrupt while entering an
|
|
.CO ex
|
|
command, the command is aborted, the cursor returns to its previous
|
|
position, and
|
|
.CO vi
|
|
remains in command mode.
|
|
.sp
|
|
Generally, if the
|
|
.LI <interrupt>
|
|
character is used to interrupt any
|
|
operation, any changes made before the interrupt are left in place.
|
|
.SS
|
|
.SP Line:
|
|
Dependent on the operation being interrupted.
|
|
.SP Column:
|
|
Dependent on the operation being interrupted.
|
|
.SP Options:
|
|
None.
|
|
.SH 1 "Vi Text Input Commands"
|
|
.pp
|
|
The following section describes the commands available in the text
|
|
input mode of the
|
|
.CO vi
|
|
editor.
|
|
.pp
|
|
Historically,
|
|
.CO vi
|
|
implementations only permitted the characters inserted on the current
|
|
line to be erased.
|
|
In addition, only the
|
|
.LI <control-D>
|
|
erase character and the
|
|
.QT 0<control-D>
|
|
and
|
|
.QT ^<control-D>
|
|
erase strings could erase autoindent characters.
|
|
(Autoindent characters include both the characters inserted automatically
|
|
at the beginning of an input line as well as characters inserted using the
|
|
.LI <control-T>
|
|
command.)
|
|
This implementation permits erasure to continue past the beginning
|
|
of the current line, and back to where text input mode was entered.
|
|
In addition, autoindent characters may be erased using the standard
|
|
erase characters.
|
|
For the line and word erase characters, reaching the autoindent
|
|
characters forms a
|
|
.QQ soft
|
|
boundary, denoting the end of the current word or line erase.
|
|
Repeating the word or line erase key will erase the autoindent characters.
|
|
.pp
|
|
Historically,
|
|
.CO vi
|
|
always used
|
|
.LI <control-H>
|
|
and
|
|
.LI <control-W>
|
|
as character and word erase characters, respectively, regardless of
|
|
the current terminal settings.
|
|
This implementation accepts, in addition to these two characters,
|
|
the current terminal characters for those operations.
|
|
.KY <nul>
|
|
.IP "<nul>"
|
|
If the first character of the input is a
|
|
.LI <nul> ,
|
|
the previous input is replayed, as if just entered.
|
|
.KY <control-D>
|
|
.IP "<control-D>"
|
|
If the previous character on the line was an autoindent character,
|
|
erase characters to move the cursor back to the column immediately
|
|
after the previous (1-based) column which is a multiple of the
|
|
.OP shiftwidth
|
|
edit option.
|
|
This may result in any number of
|
|
.LI <tab>
|
|
and
|
|
.LI <space>
|
|
characters preceding the cursor being changed.
|
|
.sp
|
|
Otherwise, if the
|
|
.OP autoindent
|
|
option is set and the user is entering the first character in the line,
|
|
.LI <control-D>
|
|
is ignored.
|
|
Otherwise, a literal
|
|
.LI <control-D>
|
|
character is entered.
|
|
.KY ^<control-D>
|
|
.IP "^<control-D>"
|
|
If the previous character on the line was an autoindent character,
|
|
erase all of the autoindent characters on the line.
|
|
In addition, the autoindent level is reset to 0.
|
|
.KY 0<control-D>
|
|
.IP "0<control-D>"
|
|
If the previous character on the line was an autoindent character,
|
|
erase all of the autoindent characters on the line.
|
|
The autoindent level is not altered.
|
|
.KY <control-T>
|
|
.IP "<control-T>"
|
|
Insert sufficient
|
|
.LI <tab>
|
|
and
|
|
.LI <space>
|
|
characters to move the cursor forward to the column immediately
|
|
after the next (1-based) column which is a multiple of the
|
|
.OP shiftwidth
|
|
edit option.
|
|
This may result in any number of
|
|
.LI <tab>
|
|
and
|
|
.LI <space>
|
|
characters preceding the cursor being changed.
|
|
.sp
|
|
Historically,
|
|
.CO vi
|
|
did not permit the
|
|
.LI <control-T>
|
|
command to be used unless the cursor was at the first column of a new
|
|
line or it was preceded only by autoindent characters.
|
|
.CO Nvi
|
|
permits it to be used at any time during insert mode.
|
|
.KY <erase>
|
|
.IP <erase>
|
|
.KY <control-H>
|
|
.Ip <control-H>
|
|
Erase the last character.
|
|
.KY "<literal-next>"
|
|
.IP "<literal-next>"
|
|
Quote the next character.
|
|
The next character will not be mapped (see the
|
|
.CO map
|
|
command for more information)
|
|
or interpreted specially.
|
|
A carat
|
|
.PQ ^
|
|
character will be displayed immediately as a placeholder,
|
|
but will be replaced by the next character.
|
|
.KY <escape>
|
|
.IP <escape>
|
|
If on the colon command line, and the
|
|
.OP filec
|
|
edit option is set, behave as described for that option.
|
|
Otherwise, if on the colon command line,
|
|
execute the command.
|
|
Otherwise, if not on the colon command line,
|
|
resolve all text input into the file, and return to command mode.
|
|
.KY "<line erase>"
|
|
.IP "<line erase>"
|
|
Erase the current line.
|
|
.KY "<control-W>"
|
|
.IP "<control-W>"
|
|
.KY "<word erase>"
|
|
.Ip "<word erase>"
|
|
Erase the last word.
|
|
The definition of word is dependent on the
|
|
.OP altwerase
|
|
and
|
|
.OP ttywerase
|
|
options.
|
|
.KY "<control-X>"
|
|
.IP "<control-X>[0-9A-Fa-f]+"
|
|
Insert a character with the specified hexadecimal value into the text.
|
|
The value is delimited by any non-hexadecimal character or the input
|
|
of the maximum number of characters that can be translated into a single
|
|
character value.
|
|
.KY <interrupt>
|
|
.IP "<interrupt>"
|
|
Interrupt text input mode, returning to command mode.
|
|
If the
|
|
.LI <interrupt>
|
|
character is used to interrupt inserting text into the file,
|
|
it is as if the
|
|
.LI <escape>
|
|
character was used; all text input up to the interruption is
|
|
resolved into the file.
|