User Commands edit(1)
NAME
edit - text editor (variant of ex for casual users)
SYNOPSIS
/usr/bin/edit [-| -s] [-l] [-L] [-R] [-r [filename]]
[-t tag] [-v] [-V] [-x] [-wn] [-C]
[+command | -c command] filename...
/usr/xpg4/bin/edit [-| -s] [-l] [-L] [-R] [-r [filename]]
[-t tag] [-v] [-V] [-x] [-wn] [-C]
[+command | -c command] filename...
/usr/xpg6/bin/edit [-| -s] [-l] [-L] [-R] [-r [filename]]
[-t tag] [-v] [-V] [-x] [-wn] [-C]
[+command | -c command] filename...
DESCRIPTION
The edit utility is a variant of the text editor ex recom-
mended for new or casual users who wish to use a command-
oriented editor. It operates precisely as ex with the fol-
lowing options automatically set: novice ON report ON showmode ON magic OFF The following brief introduction should help you get startedwith edit. If you are using a CRT terminal you might want to
learn about the display editor vi.
To edit the contents of an existing file you begin with the
command edit name to the shell. edit makes a copy of the
file that you can then edit, and tells you how many lines
and characters are in the file. To create a new file, youalso begin with the command edit with a filename: edit name;
the editor tells you it is a [New File].
SunOS 5.11 Last change: 11 Jun 2004 1
User Commands edit(1)
The edit command prompt is the colon (:), which you should
see after starting the editor. If you are editing an exist-
ing file, then you have some lines in edit's buffer (its
name for the copy of the file you are editing). When you
start editing, edit makes the last line of the file the
current line. Most commands to edit use the current line if
you do not tell them which line to use. Thus if you say print (which can be abbreviated p) and type carriage return(as you should after all edit commands), the current line is
printed. If you delete (d) the current line, edit prints the
new current line, which is usually the next line in the file. If you delete the last line, then the new last line becomes the current one. If you start with an empty file or wish to add some new lines, then the append (a) command can be used. After you execute this command (typing a carriage return after theword append), edit reads lines from your terminal until you
type a line consisting of just a dot (.); it places these lines after the current line. The last line you type then becomes the current line. The insert (i) command is like append, but places the lines you type before, rather than after, the current line.The edit utility numbers the lines in the buffer, with the
first line having number 1. If you execute the command 1,then edit types the first line of the buffer. If you then
execute the command d, edit deletes the first line, line 2
becomes line 1, and edit prints the current line (the new
line 1) so you can see where you are. In general, the current line is always the last line affected by a command. You can make a change to some text within the current line by using the substitute (s) command: s/old/new/ where old is the string of characters you want to replace and new is the string of characters you want to replace old with. The filename (f) command tells you how many lines there arein the buffer you are editing and says [Modified] if you
have changed the buffer. After modifying a file, you cansave the contents of the file by executing a write (w) com-
mand. You can leave the editor by issuing a quit (q) com-
mand. If you run edit on a file, but do not change it, it is
not necessary (but does no harm) to write the file back. Ifyou try to quit from edit after modifying the buffer without
writing it out, you receive the message No write since lastchange (:quit! overrides), and edit waits for another com-
mand. If you do not want to write the buffer out, issue theSunOS 5.11 Last change: 11 Jun 2004 2
User Commands edit(1)
quit command followed by an exclamation point (q!). The buffer is then irretrievably discarded and you return to the shell. By using the d and a commands and giving line numbers to see lines in the file, you can make any changes you want. You should learn at least a few more things, however, if you useedit more than a few times.
The change (c) command changes the current line to a sequence of lines you supply (as in append, you type lines up to a line consisting of only a dot (.). You can tell change to change more than one line by giving the line numbers of the lines you want to change, that is, 3,5c. You can print lines this way too: 1,23p prints the first 23 lines of the file. The undo (u) command reverses the effect of the last command you executed that changed the buffer. Thus if you execute a substitute command that does not do what you want, type u and the old contents of the line are restored. You can alsoundo an undo command. edit gives you a warning message when
a command affects more than one line of the buffer. Note that commands such as write and quit cannot be undone. To look at the next line in the buffer, type carriage return. To look at a number of lines, type ^D (while holding down the control key, press d) rather than carriage return.This shows you a half-screen of lines on a CRT or 12 lines
on a hardcopy terminal. You can look at nearby text by exe-
cuting the z command. The current line appears in the middle of the text displayed, and the last line displayed becomes the current line; you can get back to the line where you were before you executed the z command by typing ''. The zcommand has other options: z- prints a screen of text (or 24
lines) ending where you are; z+ prints the next screenful. If you want less than a screenful of lines, type z.11 to display five lines before and five lines after the current line. (Typing z.n, when n is an odd number, displays a total of n lines, centered about the current line; when n is aneven number, it displays n-1 lines, so that the lines
displayed are centered around the current line.) You can give counts after other commands; for example, you candelete 5 lines starting with the current line with the com-
mand d5.SunOS 5.11 Last change: 11 Jun 2004 3
User Commands edit(1)
To find things in the file, you can use line numbers if you happen to know them; since the line numbers change when you insert and delete lines this is somewhat unreliable. You can search backwards and forwards in the file for strings by giving commands of the form /text/ to search forward for text or ?text? to search backward for text. If a search reaches the end of the file without finding text, it wraps around and continues to search back to the line where you are. A useful feature here is a search of the form /^text/which searches for text at the beginning of a line. Simi-
larly /text$/ searches for text at the end of a line. You
can leave off the trailing / or ? in these commands. The current line has the symbolic name dot (.); this is mostuseful in a range of lines as in .,$p which prints the
current line plus the rest of the lines in the file. To move to the last line in the file, you can refer to it by itssymbolic name $. Thus the command $d deletes the last line
in the file, no matter what the current line is. Arithmeticwith line references is also possible. Thus the line $-5 is
the fifth before the last and .+20 is 20 lines after the current line. You can find out the current line by typing `.='. This is useful if you wish to move or copy a section of text within a file or between files. Find the first and last line numbers you wish to copy or move. To move lines 10 through 20, type 10,20d a to delete these lines from the file andplace them in a buffer named a. edit has 26 such buffers
named a through z. To put the contents of buffer a after the current line, type put a. If you want to move or copy theselines to another file, execute an edit (e) command after
copying the lines; following the e command with the name ofthe other file you wish to edit, that is, edit chapter2. To
copy lines without deleting them, use yank (y) in place of d. If the text you wish to move or copy is all within one file, it is not necessary to use named buffers. For example, to move lines 10 through 20 to the end of the file, type10,20m $.
OPTIONS These options can be turned on or off using the set command in ex(1).-C Encryption option; same as the -x
option, except that vi simulates the C command of ex. The C command is like the X command of ex, except that all text read in is assumed to have been encrypted.SunOS 5.11 Last change: 11 Jun 2004 4
User Commands edit(1)
-l Set up for editing LISP programs.
-L List the name of all files saved
as the result of an editor or sys-
tem crash.-R Readonly mode; the readonly flag
is set, preventing accidental overwriting of the file.-r filename Edit filename after an editor or
system crash. (Recovers the ver-
sion of filename that was in the buffer when the crash occurred.)-t tag Edit the file containing the tag
and position the editor at its
definition.-v Start up in display editing state
using vi. You can achieve the same effect by simply typing the vi command itself.-V Verbose. When ex commands are read
by means of standard input, the input is echoed to standard error. This can be useful when processing ex commands within shell scripts.-x Encryption option; when used, edit
simulates the X command of ex and prompts the user for a key. This key is used to encrypt and decrypt text using the algorithm of the crypt command. The X command makes an educated guess to determine whether text read in is encrypted or not. The temporary buffer file is encrypted also, using a transformed version of the keytyped in for the -x option.
SunOS 5.11 Last change: 11 Jun 2004 5
User Commands edit(1)
-wn Set the default window size to n.
This is useful when using the edi-
tor over a slow speed line.+command | -c command Begin editing by executing the
specified editor command (usually
a search or positioning command).- | -s Suppress all interactive user
feedback. This is useful whenprocessing editor scripts.
The filename argument indicates one or more files to beedited.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:/usr/bin/edit
____________________________________________________________
| ATTRIBUTE TYPE ATTRIBUTE VALUE |
| Availability SUNWcsu | | CSI Enabled ||___________________________________________________________|
/usr/xpg4/bin/edit
____________________________________________________________
| ATTRIBUTE TYPE ATTRIBUTE VALUE |
| Availability SUNWxcu4 | | CSI Enabled ||___________________________________________________________|
/usr/xpg6/bin/edit
____________________________________________________________
| ATTRIBUTE TYPE ATTRIBUTE VALUE |
| Availability SUNWxcu6 | | CSI Enabled ||___________________________________________________________|
SEE ALSO
ed(1), ex(1), vi(1), attributes(5), XPG4(5) NOTESSunOS 5.11 Last change: 11 Jun 2004 6
User Commands edit(1)
The encryption options are provided with the Security Administration Utilities package, which is available only in the United States.SunOS 5.11 Last change: 11 Jun 2004 7