ex.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

ex(1) ex(1)

NAME

ex, edit - extended line-oriented text editor

SYNOPSIS

ex [-][-l][

-r][-R][-t tag][-v][-wsize][

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

UNIX Standard Synopsis

ex [-rR][-s 

-v][-c command][-t tag ][-w size ][ﬁle ...]

Obsolescent Options

ex [-rR][- -v

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

edit [-][-l][

-r][-R][-t tag][-v][-wsize][

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

Remarks

The program names

ex, edit, vi

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

This manual entry describes the behavior of the

ex/edit personality. On many HP-UX and other simi-

lar systems,

e is a synonym for

ex.

DESCRIPTION

The

ex program is the line-oriented personality of a text editor that also supports screen-oriented editing

(see vi(1)).

(UNIX Standard only, see standards (5)) Certain block-mode terminals do not have all the capabilities

necessary to support the complete

ex deﬁnition, such as the full-screen editing commands (

visual

mode or open mode). When these commands cannot be supported on such terminals, this condition shall

neither produce an error message such as "not an editor command" nor report a syntax error.

The

edit program is identical to ex, except that some editor option defaults are altered to make the edi-

tor somewhat friendlier for beginning and casual users (see Editor Options below).

Options and Arguments

ex recognizes the following command-line options and arguments:

- (Obsolescent) Suppress all interactive-user feedback. This is useful when editor com-

mands are taken from scripts.

-s (UNIX Standard only, see standards (5))

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

from scripts.

Ignore the value of the

TERM and any implementation terminal type and assume the ter-

minal is a type incapable of supporting visual mode.

Suppress the use of the

EXINIT environment variable and the reading of the .exrc

ﬁle.

-l Set the lisp editor option (see Editor Options below).

-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 Editor

Options below).

-t tag (UNIX Standard only, see standards (5)) Edit the ﬁle containing the speciﬁed tag and

proceed as if the ﬁrst command were :tag tag . The tags represented by the -t tag and

the ta command is optional. It shall be provided on any system that also provides a

conﬁrming implementation of ctags, Otherwise, the use of the -t produces undeﬁned

results.

Execute the

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

mand in Command Descriptions and the tags editor option in Editor Options below.

-v Invoke visual mode (vi).

-w size Set the value of the window editor option to size (see Editor Options below). If size is

omitted, it defaults to 3.

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

Summary of content (20 pages)

PAGE 1
ex(1) ex(1) NAME ex, edit - extended line-oriented text editor SYNOPSIS ex [-] [-l] [-r] [-R] [-t tag ] [-v] [-wsize ] [-x] [-C] [+command] [file ...] UNIX Standard Synopsis ex [-rR] [-s  -v] [-c command] [-t tag ] [-w size ] [file ...] Obsolescent Options ex [-rR] [- -v] [+command] [-t tag ] [-w size ] [file ...] edit [-] [-l] [-r] [-R] [-t tag ] [-v] [-wsize ] [-x] [-C] [+command] [file ...] Remarks The program names ex, edit, vi, view, and vedit are separate personalities of the same program.
PAGE 2
ex(1) ex(1) -x Set encryption mode. You are prompted for a key to initiate the creation or editing of an encrypted file (see the crypt command in Command Descriptions below). -C Encryption option. Same as the -x option, except that all text read in is assumed to have been encrypted. -c command +command (UNIX Standard only, see standards (5)) (Obsolescent) Begin editing by executing the specified ex search or positioning command. file Specify the file or files to be edited.
PAGE 3
ex(1) ex(1) $ The last line in the work area. % Abbreviation for 1,$, meaning the entire work area. +n, +[+]... -n, -[-]... An offset relative to the current line or the preceding line specification. + means forward; - means backward. For example, the forms .+3, +3, and +++ are equivalent. /re / ?re ? The line containing the pattern re, scanning forward (/) or backward (?). The trailing / or ? can be omitted if the line is only being displayed.
PAGE 4
ex(1) ex(1) The character ˜ is replaced by the replacement part of the previous substitute command. Use \˜ if the nomagic editor option is set. The sequence \n, where n is an integer, is replaced by the text matched by the subpattern enclosed in the nth set of parentheses $ and $. The sequence \u (\l) causes the immediately following character in the replacement to be converted to uppercase (lowercase), if the character is a letter.
PAGE 5
ex(1) ex(1) If the buffer name is specified in uppercase, and the buffer is to be modified, the buffer shall be appended to rather than being overwritten. If the buffer is not to be modified, the buffer name can be specified in lowercase or uppercase with the same results. There shall be also one unnamed buffer, which is the repository for all text deleteed or yanked when no buffer is specified. There are also numbered buffers, 1 through 9, which shall be accessible only from visual mode.
PAGE 6
ex(1) ex(1) Change the working directory to directory . If directory is omitted, the value of the HOME environment variable is used. If the work area has been modified since the last write and the name of the file being edited does not begin with a slash (/), a warning is issued and the working directory is not changed. To force a change of directory in this case, append the character ! to the command.
PAGE 7
ex(1) ex(1) letter or a digit can be used to delimit the pattern instead of the /. command can be specified on multiple lines by hiding new-lines with a backslash. If command is omitted, each line is printed. append, change, and insert commands are allowed; the terminating dot can be omitted if it ends command or commands. The visual command is also permitted (unless the global command itself has been issued from visual mode), and takes input from the terminal.
PAGE 8
ex(1) next ex(1) n[ext][!] [ file ...] The next file from the command line argument list is edited. Appending a ! to the command overrides the warning about the work area having been modified since the last write (and discards any changes unless the autowrite editor option is set). The argument list can be replaced by specifying a new one on this command line. number range nu[mber] count flags range # count flags (The # character is an alternative abbreviation for the number command.
PAGE 9
ex(1) recover ex(1) rec[over][!] file Recover file from the save area, after an accidental hangup or a system crash. If the current work area has been modified since the last write, a warning is printed and the command is aborted. This action can be overridden by appending the character ! to the command (rec! file ). rewind rew[ind][!] The argument list is rewound, and the first file in the list is edited. This shall be equivalent to a next command with the current argument list as its operands.
PAGE 10
ex(1) ex(1) If the substitution pattern re is omitted (s//repl /), the more recently set of either the substitution string or the scanning string is used (see Regular Expressions above). If the s or & forms of the command are used, the substitution pattern defaults to the previous substitution string and the replacement string defaults to the previous replacement string used.
PAGE 11
ex(1) ex(1) A count specifies an initial window size; the default is the value of the editor option window. The flags # and l (ell) cause the lines in the visual window to be displayed in the corresponding mode (see the number and list commands). Use the Q command to exit visual mode. For more information, see vi (1).
PAGE 12
ex(1) ex(1) Shift the specified lines to the left. The number of spaces to be deleted is determined by the editor option shiftwidth. Only whitespace (blanks and tabs) is lost in shifting; other characters are not affected. The last line changed becomes the current line. (shift right) range > count flags Shift the specified lines to the right by inserting whitespace The number of spaces inserted is determined by the editor option shiftwidth. The last line changed becomes the current line.
PAGE 13
ex(1) ex(1) autowrite (aw) The work area is written out to the current file if the work area has been modified and a next, rewind, or ! command is given. Reversed by noautowrite (noaw). The default is noautowrite. beautify (bf) Cause all control characters other than tab, newline, and formfeed to be discarded from the input text. Reversed by nobeautify (nobf). The default is nobeautify. directory=dirname (dir) Specify the directory in which the editor work area should be placed.
PAGE 14
ex(1) A eA ex(1) keyboardedit When set, any keyboard editing key mappings that are loaded automatically at initialization for command-mode use are enabled. If not set, these mappings are disabled (but not deleted). Use the map command to get a list of the currently enabled command-mode mappings. Reversed by nokeyboardedit. The default is keyboardedit. keyboardedit! When set, the keyboard editing key mappings automatically loaded at initialization for input mode use are enabled.
PAGE 15
ex(1) ex(1) redraw Simulate an intelligent terminal on a dumb terminal. During input mode, lines are continuously reprinted as text is entered. Since this is likely to require a large amount of output to the terminal, it is useful only at high transmission speeds. If noredraw is set, lines are reprinted only when input mode is terminated and deleted lines are marked with an @ in the left margin. Reversed by noredraw. The default is redraw.
PAGE 16
ex(1) ex(1) When you enter a line mode tag command or visual mode ˆ] command, the current line number and file name are stored on the tag stack. A future line mode pop command or visual mode ˆT command will return to the stored file name at the stored line number. If the tag stack is disabled and then reenabled again, the stack continues where it left off. The pop command does not work when the tag stack is disabled. A term=termtype Define the type of terminal being used with the editor.
PAGE 17
ex(1) ex(1) LINES overrides the system-selected vertical screen size, used as the number of lines in a screenful and as the vertical screen size in visual mode. PATH determines the search path for the shell command specified in the editor commands, shell, read, and write. SHELL is variable that shall be interpreted as the preferred command-line interpreter for use in !, shell, read, and other commands with an operand of the form !string.
PAGE 18
ex(1) ex(1) The pathname of the file being edited by ex is referred to as the current file. The text of the file shall be read into a working version of the file (called buffer in this clause), and all editing changes shall be performed on that version; the changes shall have no effect on the original file until an ex command causes the file to be written out. Lines in the buffer may be limited to 4096 characters including 2-3 bytes for overhead.
PAGE 19
ex(1) ex(1) FILES $HOME/.exrc ./.exrc /usr/lbin/expreserve /usr/lbin/exrecover /usr/share/lib/terminfo/*/* /var/preserve /var/tmp/Ex* /var/tmp/Rx* Primary editor initialization file Secondary editor initialization file Preserve command Recover command Description of terminal capabilities Preservation directory Editor temporary file Named buffer temporary file SEE ALSO ctags(1), ed(1), stty(1), vi(1), write(1), terminfo(4), environ(5), lang(5), regexp(5), standards(5).
PAGE 20
(Notes) A (Notes) eA 20 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010