vi.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

vi(1) vi(1)

NAME

vi, view, vedit - screen-oriented (visual) text editor

SYNOPSIS

vi [-][-l][

-r][-R][-t tag][-v][-V][-w

size][-x][-C][+command][ﬁle ]...

UNIX Standard Synopsis

vi [-rR][-c command][

-t tag][-w size ][ﬁle]...

Obsolescent Options

vi [-rR][+command][

-t tag][-w size ][ﬁle]...

view [-][-l][

-r][-R][-t tag ][-v][-V][-w

size][-x][-C][+command][ﬁle ]...

vedit [-][-r][

-R][-l][-t tag ][-v][-V][-w

size][-x][-C][+command][ﬁle ]...

Remarks

The program names

ex, edit, vi

, view, and vedit are separate personalities of the same program.

This manpage describes the behavior of the

/view/vedit personality.

DESCRIPTION

The

vi (visual) program is a display-oriented text editor that is based on the underlying

ex line editor

(see ex(1)). It is possible to switch back and forth between the two and to execute

ex commands from

within

vi. The line-editor commands and the editor options are described in ex (1). Only the visual mode

commands are described here.

The

view program is identical to vi except that the readonly editor option is set (see ex (1)).

The

vedit program is somewhat friendlier for beginners and casual users. The report editor option is

set to 1, and the nomagic, novice, and showmode editor options are set.

vi, the terminal screen acts as a window into a memory copy of the ﬁle being edited. Changes made to

the ﬁle copy are reﬂected in the screen display. The position of the cursor on the screen indicates the

position within the ﬁle copy.

The environment variable

TERM must specify a terminal type that is deﬁned in the

terminfo database

(see terminfo (4)). Otherwise, a message is displayed and the line-editor is invoked.

As with

ex, editor initialization scripts can be placed in the environment variable

EXINIT, or in the ﬁle

.exrc in the current or home directory.

Options

vi recognizes the following command-line options:

- Suppress all interactive-user feedback. This is useful when editor commands are

taken from scripts.

-l Set the lisp editor option (see ex (1)). Provides indents appropriate for

lisp code.

The

(, ), {, }, [[, and ]] commands in vi are modiﬁed to function with lisp

source code.

-r Recover the speciﬁed ﬁles after an editor or system crash. If no ﬁle is speciﬁed, a

list of all saved ﬁles is printed. You must be the owner of the saved ﬁle in order to

recover it (superuser cannot recover ﬁles owned by other users).

-R Set the readonly editor option to prevent overwriting a ﬁle inadvertently (see

ex(1)).

-t tag Execute the tag tag command to load and position a predeﬁned ﬁle. See the tag

command and the tags editor option in ex (1).

-v Invoke visual mode (vi). Useful with ex, it has no effect on vi.

-V Set verbose mode. Editor commands are displayed as they are executed when input

from a .exrc ﬁle or a source ﬁle (see the source command in ex(1)).

-wsize Set the value of the window editor option to size.Ifsize is omitted, it defaults to 3.

-x Set encryption mode. You are prompted for a key to allow for the creation or editing

of an encrypted ﬁle. This command makes an educated guess to determine whether

text read in is encrypted or not. The temporary buffer ﬁle is encrypted also, using a

transformed version of the key typed in for the -x option (see the crypt command

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (10 pages)

PAGE 1
vi(1) vi(1) NAME vi, view, vedit - screen-oriented (visual) text editor SYNOPSIS vi [-] [-l] [-r] [-R] [-t tag ] [-v] [-V] [-wsize ] [-x] [-C] [+command] [file ]... UNIX Standard Synopsis vi [-rR] [-c command] [-t tag ] [-w size ] [file ]... Obsolescent Options vi [-rR] [+command] [-t tag ] [-w size ] [file ]... view [-] [-l] [-r] [-R] [-t tag ] [-v] [-V] [-wsize ] [-x] [-C] [+command] [file ]... vedit [-] [-r] [-R] [-l] [-t tag ] [-v] [-V] [-wsize ] [-x] [-C] [+command] [file ]...
PAGE 2
vi(1) vi(1) in ex(1)). -C Encryption option. Same as the -x option, except that all text read in is assumed to have been encrypted. -c command +command (Under UNIX Standard only, see standards (5)) (Obsolescent) Begin editing by executing the specified ex command-mode commands. As with the normal ex command-line entries, the command optionargument can consist of multiple ex commands separated by vertical-line commands (|).
PAGE 3
vi(1) vi(1) ^B Scroll backward to display the previous window of text. A preceding count specifies the number of windows to go back. Two lines of overlap are kept if possible. ^D Scroll forward a half-window of text. A preceding count gives the number of (logical) lines to scroll, and is remembered for future ˆD and ˆU commands. ^D (input mode) Backs up over the indentation provided by autoindent or ˆT to the next multiple of shiftwidth spaces.
PAGE 4
vi(1) vi(1) ^\ Exit vi and enter ex command mode. If in input mode, terminate the input first. ^] Take the word at or after the cursor as a tag and execute the tagMbobC editor command (see ex(1)). ^ˆ Return to the previous file (equivalent to :ex #). space Move one space to the right (stops at the end of the line). A preceding count specifies the number of spaces to go forward (same as l). erase Erase, where erase is the user-designated erase character (see stty (1)). Same as ˆH.
PAGE 5
vi(1) vi(1) ) Move forward to the beginning of a sentence. If a count is specified, the cursor advances the specified number of sentences (see (). { Move back to the beginning of the preceding paragraph. A paragraph is defined by the value of the paragraphs option. A completely empty line and a section boundary (see [[ above) are also interpreted as the beginning of a paragraph. If a count is specified, the cursor moves backward the specified number of paragraphs.
PAGE 6
vi(1) A vi(1) ~ The tilde (˜) switches the case of the character under the cursor (if it is a letter), then moves one character to the right, stopping at the end of the line). A preceding count specifies how many characters in the current line are switched. A Append at the end of line (same as $a). B Back up one word, where a word is any nonblank sequence, placing the cursor at the beginning of the word. If a count is specified, the cursor moves back the specified number of words.
PAGE 7
vi(1) vi(1) W Move forward to the beginning of a word in the current line, where a word is a sequence of nonblank characters. If the current position is at the beginning of a word, the current position is within a bigword or the character at that position cannot be a part of a bigword, the current position shall move to the first character of the next bigword.
PAGE 8
vi(1) vi(1) s Delete the single character under the cursor and enter input mode; the entered text replaces the deleted character. A preceding count specifies how many characters on the current line are changed. The last character being changed is marked with a $, as for c. t Must be followed by a single character; scan the remainder of the line for that character. The cursor moves to the column prior to the character if the character is found.
PAGE 9
vi(1) vi(1) terminfo entry command mode map input mode map map name description key_ic key_eic key_up key_down key_left key_right key_home key_il key_dl key_clear key_eol key_sf key_dc key_npage key_ppage key_sr key_eos i i k j h l H oˆ[ dd ˆL d$ ^E x ˆF ˆB ^Y dG ^[ ^[ ^[ka ^[ja ^[ha ^[la ^[Ha ^[oˆ[a ^[dda ^[ˆLa ^[d$a ^[ˆEa ^[xa ^[ˆFa ^[ˆBa ^[ˆYa ^[dGa inschar inschar up down left right home insline delline clear clreol scrollf delchar npage ppage sr clreos insert char end insert char arrow up ar
PAGE 10
vi(1) vi(1) variable contains an invalid setting, the editor behaves as if all internationalization variables are set to "C". See environ (5). International Code Set Support Single- and multi-byte character code sets are supported. WARNINGS See also the WARNINGS section in ex(1). Program Limits vi places the following limits on files being edited. Maximum Line Length 4096 characters including 2-3 bytes for overhead. Thus, a line length up to 4092 characters should cause no problem.