src/world/usr.bin/ex/READ_ME

1310 lines
53 KiB
Plaintext

This is version 3 of the editor. It is too large to fit on a pdp-11
unless you have overlay code. (Such code is available for v7 unix on 2bsd.)
Version 2.13 corresponds to version 3 without the enhancements in 3.
There is no reason to use 2.13 unless you have a pdp-11 that does not have
overlay software, since 3 contains all the bug fixes and some new features.
Special installation notes for this version.
2) The include file varargs.h should be installed, as the printf here needs it.
3) The include file local/uparm.h should be installed, as ex_tune.h needs it.
The contents of this include file can be modified if you wish to place
the editor in a nonstandard location.
Conditional compilation flags:
-DTRACE for debugging (wont then fit on an 11)
-DVFORK for UCB Vax/Unix with the vfork system call.
-DCHDIR compile in undocumented old chdir (cd) command
-DLISP compile in lisp hacks
-DUCVISUAL compile in code to handle \ escapes for visual on
upper case only terminals. gross.
-DCRYPT -x option to edit encrypted files
-DFLOCKFILE compile in advisory file locking ala 4.[23X]
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Version 3.7 October 16, 1981
It is now possible to split lines with substitute commands from vi,
by using ^V<return> in the rhs. This takes care of the last
good reason for using ex command mode.
Mode lines are now supported. Put a line containing
ex: xxx :
in the first or last 5 lines of the file, where xxx is any ex
command you want executed when that file is read in. To make
other programs happy, it should probably be inside a comment.
You can use vi: as well as ex:. (Note: no space allowed
between the "ex" and ":". The spaces around xxx are considered
part of the command, and so are optional.)
If there is a file .exrc in the current directory, it will be
sourced when you enter vi, after your EXINIT or ~/.exrc.
The changeable scrolling region of the vt100 is now used in
place of insert line, resulting in much better performance.
Vi uses the new AL, DL, LE, RI, DO, and UP (all upper case)
termcap capabilities, which are parameterized versions of their
lower case equivalents. This will results in better performance
on ANSI terminals, and especially on the Tektronix 4025 which
has parameterized local motions but cannot cursor address.
Vi uses backtabs again. Now it knows how to handle backtabs on
terminals that have tabs set at intervals other than 8, and it
won't use backtabs if gtty indicates it can't use tabs.
A bug causing <escape> <del> to core dump vi has been fixed.
A bug causing writes to filters when editing encrypted files
to write encrypted text has been fixed.
A bug causing the message "substitution loop", when you enter a
1,$s/xxx/yyy/g with lots of changes, has been fixed.
A bug causing the current directory to be chmodded to 0 if you
set nomesg after starting up the editor has been fixed. Note
that the nomesg option is intended for your EXINIT, since it only
takes effect on entry to the editor.
The eat newline glitch has been fixed so that vt100's and tab132's
handle long lines correctly.
Some internal changes have been made so that vi can run under UNIX
on the Bell Labs 3B machine, the BBN C/70, and the IBM 370.
Version 3.6 October 30, 1980
A kernel problem on the V7 pdp-11 overlay systems which causes
bad EMT traps to happen randomly, core dumping the editor,
has been programmed around by catching EMT traps.
A bug which prevented using a screen larger than 48 lines has
been fixed.
A bug which allowed you to set window to a value larger than
your screen size has been fixed.
The screen size limit on non-VM/Unix systems has been increased
to 66 lines or 5000 characters, to allow the Ann Arbor Ambassador
terminal to be used.
A bug which caused hangups to be ignored on USG systems has
been fixed.
A bug which caused maps with multiple changes on multiple lines
to mess up has been fixed.
If you get I/O errors, the file is considered "not edited" so
that you don't accidently clobber the good file with a munged
up buffer.
An inefficiency in 3.5 which caused the editor to always call
ttyname has been fixed.
A bug which prevented the "source" command from working in an
EXINIT or from visual has been fixed.
A bug which caused readonly to be cleared when reading from
a writable file with "r" has been fixed.
The name "suspend" has been made an alias for "stop".
The stop command now once again works correctly from command mode.
On a dumb terminal at 1200 baud, "slowopen" is now the default.
A bug in the shell script "makeoptions" which searched for a
string that appeared earlier in a comment has been fixed.
A bug that caused an infinite loop when you did ":s/\</&/g"
has been fixed.
A bug that caused & with no previous substitution to give
"re internal error" has been fixed.
A bug in the binary search algorithm for tags which sometimes
prevented the last tag in the file from being found has been fixed.
Error messages from expreserve no longer output a linefeed,
messing up the screen.
The message from expreserve telling you a buffer was saved when
your phone was hung up has be amended to say the editor was
terminated, since a kill can also produce that message.
The "directory" option, which has been broken for over
a year, has been fixed.
The "r" command no longer invokes input mode macros.
A bug which caused strangeness if you set wrapmargin to 1
and typed a line containing a backslash in column 80 has
been fixed.
A bug which caused the "r<cr>" at the wrapmargin column
to mess up has been fixed.
On terminals with both scroll reverse and insert line,
the least expensive of the two will be used to scroll up.
This is usually scroll reverse, which is much less annoying
than insert line on terminals such as the mime I and mime 2a.
A bug which caused vi to estimate the cost of cursor motion
without taking into account padding has been fixed.
The failure of the editor to check counts on ^F and ^B commands
has been fixed.
The "remap" option failed completely if it was turned off.
This has been fixed.
A check of the wrong limit on a buffer for the right hand side
of substitutions has been fixed. Overflowing this buffer could
produce a core dump.
A bug causing the editor to go into insert mode if you typed
return during an R command has been fixed.
A bug preventing the + command from working when you edit a
new file has been fixed by making it no longer an error to
edit a new file (when you first enter the editor.) Instead
you are told it is a new file.
If an error happens when you are writing out a file, such as
an interrupt, you are warned that the file is incomplete.
Version 3.5 -- August 20, 1980
The provisions for changing the window size with a numeric
prefix argument to certain visual commands have been deleted.
The correct way to change the window size is to use the z
command, for example z5<cr> to change the window to 5 lines.
The code to handle the -x (encryption) option has been made
conditionally compiled, so that ex can run on an an 11/34 (!)
with overlays. Since this code calls getpass, stdio was
being pulled in even without VMUNIX being defined. The
savings from not defining CRYPT are about 4K of text and 4.5K
of bss.
Bill Joy put in a buffering scheme under the VMUNIX flag so
that up to 64K of file is edited in-core until you make enough
changes to force a temp file sync. This makes entry into the
editor much faster, but also makes vi much bigger.
The source to ex is now sccs'ed.
An undocumented "feature" which caused the ^^ command to return
to the previous tag, if in the current file, instead of the
previous file, has been removed.
A bug which prevented ex from compiling on systems with the new
tty driver but no process control (such as Cory) was fixed.
Version 3.4 -- June 24, 1980
The visual page motion commands ^F and ^B now treat any preceding
counts as number of pages to move, instead of changes to the
window size. That is, 2^F moves forward 2 pages.
A :vi <file> command from visual mode is now treated the same
as a :edit <file> or :ex <file> command. The meaning of the
vi command from ex command mode is not affected.
Provisions to handle the new process stopping features of the
Berkeley TTY driver have been added. A new command, "stop",
takes you out of the editor cleanly and efficiently, returning
you to the shell. Resuming the editor puts you back in command
or visual mode, as appropriate. If autowrite is set and there
are outstanding changes, a write is done first unless you say
"stop!". From visual mode, the command ^Z is the same as :stop.
Note that if you have an arrow key that sends ^Z the stop function
will take priority over the arrow function. If you have your
"susp" character set to something besides ^Z, that key will be
honored as well.
A read only mode now lets you guarantee you won't clobber your
file by accident. You can set the on/off option "readonly" (ro)
and writes will fail unless you use an ! after the write.
Commands such as x, ZZ, and autowrite, and in general anything
that writes is affected. This option is turned on if you invoke
ex with the -R flag. A new link called "view" has been created.
View is just like vi but it sets readonly.
The encryption code from the v7 editor is now part of ex.
You invoke ex with the -x option and it will ask for a key,
as ed. The ed "x" command (to enter encryption mode from
within the editor) is not available.
The editor now adopts the convention that a null string in the
environment is the same as not being set. This applies to
TERM, TERMCAP, and EXINIT.
A word abbreviation mode is now available. You can define
abbreviations with the abbreviate command
:abbr foo find outer otter
which maps "foo" to "find outer otter". Abbreviations can be
turned off with the "unabbreviate" command. The syntax of these
commands is identical to the map and unmap commands, except
that the ! forms do not exist. Abbreviations are considered
when in visual input mode only, and only affect whole words
typed in, using the conservative definition. (Thus "foobar"
will not be mapped as it would using map!)
Abbreviate and unabbreviate can be abbreviated to "ab" and
"una", respectively.
The editor now supports certain terminals that use strings other
then \r and \n for return and linefeed by implementing the cr
and nl termcap options. (Thanks to UCLA for these enhancements).
The termcap attribute ns is now checked for, and ex refuses to
go into visual mode on such a terminal unless it has sf.
Terminals that can cursor address but cannot go up a line
now work in visual.
If you change your start and stop characters to something other
than the default ^S and ^Q, vi now turns them off. This causes
people who change them to escape not to lose so badly.
The quit character is once again turned off so that datamedias
which send ^\ for the right arrow key work.
The ~ command now repeats correctly with ".".
If you type in an unmatched ) or } in showmatch mode, the editor
will now beep to warn you about your mistake. The ) or } is
still accepted.
The way macros are undone has been improved considerably.
The number of changes inside the macro is counted, and just
before the second change the state before the macro is recreated
internally and saved to allow the macro to be undoable as a unit.
Hence, if the macro makes only one change the particular change is
undone (which will probably not redraw the screen). If no changes
are made (for example, the arrow keys) the previous thing that could
be undone is not clobbered.
The undomacro option has been deleted since it is no longer needed.
Editor scripts can now contain comments. Begin the comments with "
(double quote). Comments can be on their own line or come at the
end of command lines. The comment continues to the end of the line.
The 3rd version of the USG tty driver is now supported, making it
possible on USG systems to interrupt redrawing the screen and to
not flush output when interruptable commands take place.
The rewind command has been added to the list of commands that
the autowrite option knows about.
The wrapmargin option is now usable. The way it works has been
completely revamped. Now if you go past the margin (even in the
middle of a word) the entire word is erased and rewritten on the
next line. This changes the semantics of the number given to
wrapmargin. 0 still means off. Any other number is still a
distance from the right edge of the screen, but this location
is now the right edge of the area where wraps can take place,
instead of the left edge. Wrapmargin now behaves much like
fill/nojustify mode in nroff.
A bug on the USG system where hanging up the phone causes more
than one SIGHUP to be sent has been compensated for.
A bug which caused the :sh command not to send the vs and ti
sequences when you returned has been fixed.
A bug which caused a file that bombed out in the middle of
an edit command to be considered modified has been fixed.
A bug which caused the screen to be wrong after undoing a
:move command has been fixed.
A bug which messed up the buffer and the screen after
undoing a :join command has been fixed.
The source file ex_io.c has been split into ex_io.c and
ex_unix.c to avoid a problem where many C compilers overflowed
the symbol table.
A bug which prevented turning off your prompt in your .exrc
has been fixed.
Some of the code internal to the editor has been rearranged
and some comments added.
The bug fix to the USG tty driver to output a null character
as padding at 1200 baud has been improved to output a DEL
at 1200 baud or above.
Terminals with small screens (less than 20 columns or less
than 5 lines) should now work.
A bug which prevented you from entering the character DEL
into the buffer if you changed your interrupt character to
something else besides DEL has been fixed.
A bug which caused the current line to be clobbered when
you did a /, ?, or : command which mapped an input macro
successfully has been fixed.
If you map o to O and O to o and have remap set, the editor
now catches the infinite loop.
A put command after a macro now beeps instead of putting
a copy of the whole buffer. (Note that the arrow keys
on terminals are considered macros.)
A bug which caused things like d) and d} to miss the last
character when they should have deleted to the end of the
buffer has been fixed.
A bug which caused the last character to be lost when you
read in a file with no newline at the end of the last line
has been fixed.
A bug that caused garbage to be in the buffer if the temp file
overflowed has been fixed. (This only affected non-VMUNIX systems
since the temp file cannot overflow on VMUNIX.)
When a macro or global is undone, you no longer get picked up and
dropped on line 1.
The character | can now be escaped with \| in file names.
A bug which prevented the confirm option to a substitution that
was inside a source command has been fixed.
A bug which caused the editor to not work if the tab stop size
did not divide the screen width has been fixed.
A bug on HP terminals that caused the screen to be messed up if
you scrolled up something that began the same way as the echo line
has been fixed.
A macro bug which sometimes caused the next character after an
escape to be ignored on an HP terminal has been fixed.
A bug which caused unmap of strings with length 2 to fail has been
fixed.
A bug which left vi confused if you invoked a macro containing a
quit to command mode and then did an undo has been fixed.
An old ed bug which caused globals to fail when they did a substitute
on the next line has been fixed.
The % operator will now find matching square brackets the same way
it does parentheses and braces. It will not display them in
showmatch mode, however, and will not use a ] to match all ('s.
Code has been added to handle the Beehive Superbee terminal,
using f1 for escape and f2 for control C.
The default value of the option shell is now taken from the
environment variable SHELL, if present.
Version 3.3 -- February 2, 1980
The default window sizes have been changed. At 300 baud the
window is now 8 lines (was 1/2 the screen size). At 1200 baud
the window is now 16 lines (was 2/3 the screen size, which was
usually also 16 for a typical 24 line CRT). At 9600 baud the
window is still the full screen size. Any baud rate less than
1200 behaves like 300, any over 1200 like 9600.
A new command mode command "x" (for "xit") has been added. This
is the same as wq but will not bother to write if there have been
no changes to the file. The command letter was chosen for
convenience and compatibilty with hed.
The command "ZZ" from vi is the same as ":x<cr>". This is
the recommended way to leave the editor. Z must be typed twice
since this is two easy to type by accident and has such severe
effects if unintentional.
The options w300, w1200, and w9600 can be set. They are synonyms
for "window", but only apply at 300, 1200, or 9600 baud, resp.
Thus you can specify you want a 12 line window at 300 baud and
a 23 line window at 1200 baud with
:set w300=12 w1200=23
It is now possible to say
:set window=5
and get the effect the next time the screen is redrawn from scratch.
(^L and Hit return to continue don't start from scratch.)
This is sort of pointless, since both
5:<cr>
and
z5<cr>
do the same thing with better results.
The editor no longer uses nondestructive space, except when in
insert mode. It instead prints the character it would be
moving over. This is a real win on terminals that use an
escape sequence to nd space.
It is now possible from visual to string several search expressions
together separated by semicolons the same as command mode. For
example, you can say
/foo/;/bar
from visual and it will move to the first "bar" after the next "foo".
This also works within one line.
The option "mapinput" is dead. It has been replaced by a much
more powerful mechanism: :map! (e.g. put an ! after the map).
Map and unmap commands with ! apply only to input, others apply
only to command mode.
The new option "timeout" (default on) causes macros to time out
after one second. Turn it off and they will wait forever.
By using map! and setting notimeout, it is possible to get the
effect of emacs abbreviation mode. Sanity checking is turned off
for map when ! is present. This is a crude facility and does not
take into account things like the abbreviation being part of a longer
word. It also does not echo until it is satisfied.
The new option "remap" (default on) causes the editor to attempt
to map the result of a macro mapping again until the mapping fails.
This makes it possible, say, to map q to # and #1 to something else
and get q1 mapped to something else. Turning it off makes it possible
to map ^L to l and map ^R to ^L without having ^R map to l.
The new option "undomacro" (default on) makes it possible to undo
macros as a unit. Leaving it off causes macros not to be treated
specially. Macros with zero or one change work better with noum,
with two or more changes better with um. This option may go away
if it becomes unnecessary.
The new (string) valued option "tags" allows you to specify a list
of tag files, similar to the "path" variable of csh. The files
are separated by spaces (which are entered preceded by a backslash)
and are searched left to right. The default value is
"tags /usr/lib/tags", which has the same effect as before.
It is recommended that "tags" always be the first entry.
On Ernie, /usr/lib/tags contains entries for the system defined
library procedures from section 3 of the manual.
^R is now the same as ^L on terminals where the right arrow key
sends ^L (The tvi and the adm 31).
Looking for a tag now uses binary search.
The "q" command from visual no longer works at all. You must
use "Q" to get to ex command mode.
A minor incompatibility with the v7 ed has been fixed. Previously,
to do a global substitute with an escaped newline in the rhs, you
had to put two \'s in ex and one in ed. Ex now accepts the single
form as well as the double form. For example, instead of
g/foo/s//foo\\
bar/g
(which still works), you can now type, as in ed,
g/foo/s//foo\
bar/g
This means that the following ex command, which used to "work":
g/foo/s//foo bar\
.+1,/mumble/d
won't work anymore unless you put the trailing / on the substitution.
This usage is pretty obscure anyway.
Several bugs relating to undoing macros have been fixed.
A bug which caused the command "g/pattern" to print an error
message if "pattern" occurred on the last line has been fixed.
If you reply ":" to "Hit return to continue", you will again be
asked "Hit return to continue" after the next command finishes.
Limits have been raised so that an Ann Arbor terminal can be used,
and long tags can now be accomodated.
The maximum length of a string valued option has been raised from
32 to 64, for the benefit of the "tags" option.
It is now possible to search for an escape or delete using f, F, t,
T, ;, and ,. These characters must be quoted with ^V.
The option "ttytype" is now in correct alphabetical order.
A bug that caused HP terminals to mess up in insert mode when inserting
before a tab which follows 7 or fewer characters at the beginning of a
line (such as a tags file) has been fixed.
It is now possible to include control D in your EXINIT or .exrc.
A bug which caused the screen to mess up when a glob (such as xx*)
doesn't match anything has been fixed.
The editor now checks for extra junk after a /r.e./ from visual
(other than the allowed z command) and beeps if any is found.
Previously it was just ignored.
A bug that caused j and k (up and down) to behave strangely after
an insertion has been fixed.
A bug which causes term to be displayed incorrectly and which
caused a crash when changing terminal type when there happened
to be several |'s and a long string in genbuf has been fixed.
This bug was introduced in ex 2.9.
The patch for echo lines longer than 80 characters has been
repaired to do "Hit return to continue" after such lines and
print the entire output.
A bug that caused a messed up screen after a :sh command from
open mode has been fixed.
A bug which caused a tag request for a nonexistant tag to leave
the editor in nomagic mode has been fixed.
A bug which caused strange behavior if there is no default file
name when an autowrite save is attempted has been fixed.
A bug which caused the cursor to go to the wrong position when
^^D or 0^D is entered from column 2 in autoindent mode on terminals
that can backspace has been fixed.
Version 3.2 -- January 4, 1980
A bug that caused nomagic to be set if an error happened within
a tag command has been fixed.
A bug that caused put commands to beep after a macro containing
an error has been fixed.
The mapinput option has been placed in alphabetical order.
A bug that caused undo to undo more than one macro invocation
on the same line has been fixed.
On non VM/UNIX systems, the screen size has been increased to
allow a 40 X 80 Ann Arbor to be used.
Version 3.2 -- December 28, 1980
Several limits have been increased for VM/UNIX. Longer lines,
more characters of file names, longer regular expressions, etc.
Huge files can now be edited directly. Larger terminals (up to
66 lines) can be used.
An internal change has been made for VM/UNIX that causes error
messages to be stored directly instead of in a disk file.
This should cause faster response to errors.
Version 3.1.1 -- December 13, 1979
A bug that caused nested macros not to be undoable has been fixed.
A bug that caused pounding on the escape key on terminals with
arrow keys that send escape sequences to cause undo to screw up
has been fixed.
It is now acknowledged that macros cannot contain the put command.
This is due to the implementation of put - previously a put inside
a macro dumped a copy of the buffer instead of the desired text and
left the editor in a very strange state. Now such a put just beeps.
Version 3.1 -- November 1, 1979
Versions from 3.1 up are too large to fit on pdp-11's.
(Special overlay software is expected to be available soon
for v7 pdp-11 Unix that will make it fit.) Version 2.9
is 3.1 with only the bug fixes and very few of the enhancements.
2.9 will fit on a pdp-11. Version 2.10 will come out and may
correspond to 3.2. (It turned out to correspond to 3.3)
For compatibility with ed: 's<newline>' may be used as a
command and means '&'. If you set the option "edcompatible"
(abbr "ed") the presense or abscence of g and c suffices is
remembered and can be toggled by repeating the suffices. The
suffix "r" makes the substitution into "~" instead of "&".
A new command line option -w<n> sets the value of window before
starting ex. Hence: 'vi -w5 file' makes a quick change to a file
easier at 300 baud.
Arrow keys on terminals that send more than 1 character now
work. Home up keys are supported as are the four directions.
Ex no longer looks at the ma= entry in termcap, but uses the
ku, kd, kl, kr, and kh entries. (Note that the HP 2621 will
turn on function key labels, and even then you have to hold
shift down. To avoid turning on the labels, and to give up the
function keys, use terminal type 2621nl instead of 2621.)
A parameterless macro facility is included from visual. Briefly,
there are two flavors of macros:
a) Put the macro body in a buffer register, say x. Then
type @x to invoke it. @ may be followed by another @
to repeat the last macro.
This allows macros up to 512 chars.
b) Use the map command from command mode (typically in the
.exrc file) as follows:
map lhs rhs
where lhs will be mapped to rhs.
There are restrictions: lhs's should be 1-keystroke
(either 1 char or 1 function key) since they must be
entered within 1 second. lhs no longer than 10 chars,
rhs no longer than 100. To get " ", "\t", "|", or "\n"
into lhs or rhs, escape them with ctrl V. (It may be
necessary to escape the ctrl V with ctrl V if the map
command is given from visual mode.)
For 1 shot macros it is best to put the macro in a buffer register
and map a key to '@r', since this will allow the macro to be edited.
Macros can be deleted with
unmap lhs
The boolean option "mapinput" (mi) will, if on, cause macros to
be mapped in input mode as well as command mode (in visual only).
For example, you can define ctrl T to be four spaces with
:map ^V^T_^V^V____
:set mi
where underlines represent spaces and the ctrl V's are necessary
to get ctrl chars and spaces past various levels, and make ^T be
a software tab that even works in the middle of a line.
If the lhs of a macro is "#0" through "#9", this maps the particular
function key instead of the 2 char # sequence, if the terminal has
function keys. This only works if termcap has function key entries
for the particular terminal. For terminals without function keys,
the sequence #x means function key x, as typed. As a special case,
on terminals without function keys, the #x sequence need not be
typed within one second. The character # can be changed by using
a macro in the usual way:
map ^V^I #
to use tab, for example. (This won't affect the map command, which
still uses #, but just the invocation from visual mode.)
The undo command will undo an entire macro call as a unit.
New commands in visual: ^Y and ^E. These glitch the screen up
and down 1 line, respectively. They can be given counts, controlling
the number of lines the screen is glitched. They differ from ^U
and ^D in that the cursor stays over the same line in the buffer
it was over before rather than staying in the same place on the
screen. (^Y on a dumb terminal with a full screen will redraw the
screen moving the cursor up a few lines.) If you're looking for
mnemonic value in the names, try this: Y is right next to U and
E is right next to D.
More new commands in visual: '&' is a synonym for ':&<cr>'.
'~' changes the case of the letter under the cursor and moves
to the next character.
Ex looks in your environment for EXINIT. If it finds it, that
is used instead of looking for your .exrc. This should make
entry into ex faster, along with the termlib feature of looking
for a termcap entry in TERMCAP.
Version 2.13 -- September 23, 1980
The provisions for changing the window size with a numeric
prefix argument to certain visual commands have been deleted.
The correct way to change the window size is to use the z
command, for example z5<cr> to change the window to 5 lines.
An undocumented "feature" which caused the ^^ command to return
to the previous tag, if in the current file, instead of the
previous file, has been removed.
Version 2.12 -- July 23, 1980
A change was made to the sys_errlist array in ex_subr.c so that
Berkeley V7 quotas will produce the right error message.
A couple of minor bug fixes were made to get the editor to
compile on version 6. The option to use 1K BUFSIZ has been
deleted, since it is no longer used on our 1K system.
Version 2.11 -- June 24, 1980
The visual page motion commands ^F and ^B now treat any preceding
counts as number of pages to move, instead of changes to the
window size. That is, 2^F moves forward 2 pages.
A :vi <file> command from visual mode is now treated the same
as a :edit <file> or :ex <file> command. The meaning of the
vi command from ex command mode is not affected.
A read only mode now lets you guarantee you won't clobber your
file by accident. You can set the on/off option "readonly" (ro)
and writes will fail unless you use an ! after the write.
Commands such as x, ZZ, and autowrite, and in general anything
that writes is affected. This option is turned on if you invoke
ex with the -R flag. A new link called "view" has been created.
View is just like vi but it sets readonly.
The editor now supports certain terminals that use strings other
then \r and \n for return and linefeed by implementing the cr
and nl termcap options. (Thanks to UCLA for these enhancements).
The termcap attribute ns is now checked for, and ex refuses to
go into visual mode on such a terminal unless it has sf.
If you change your start and stop characters to something other
than the default ^S and ^Q, vi now turns them off. This causes
people who change them to escape not to lose so badly.
The quit character is once again turned off so that datamedias
which send ^\ for the right arrow key work.
If you type in an unmatched ) or } in showmatch mode, the editor
will now beep to warn you about your mistake. The ) or } is
still accepted.
Editor scripts can now contain comments. Begin the comments with "
(double quote). Comments can be on their own line or come at the
end of command lines. The comment continues to the end of the line.
The 3rd version of the USG tty driver is now supported, making it
possible on USG systems to interrupt redrawing the screen and to
not flush output when interruptable commands take place.
The rewind command has been added to the list of commands that
the autowrite option knows about.
A bug on the USG system where hanging up the phone causes more
than one SIGHUP to be sent has been compensated for.
A bug which caused a file that bombed out in the middle of
an edit command to be considered modified has been fixed.
The source file ex_io.c has been split into ex_io.c and
ex_unix.c to avoid a problem where many C compilers overflowed
the symbol table.
A bug which prevented turning off your prompt in your .exrc
has been fixed.
Some of the code internal to the editor has been rearranged
and some comments added.
The bug fix to the USG tty driver to output a null character
as padding at 1200 baud has been improved to output a DEL
at 1200 baud or above.
Terminals with small screens (less than 20 columns or less
than 5 lines) should now work.
A bug which prevented you from entering the character DEL
into the buffer if you changed your interrupt character to
something else besides DEL has been fixed.
A bug which caused things like d) and d} to miss the last
character when they should have deleted to the end of the
buffer has been fixed.
A bug which caused the last character to be lost when you
read in a file with no newline at the end of the last line
has been fixed.
A bug that caused garbage to be in the buffer if the temp file
overflowed has been fixed.
The character | can now be escaped with \| in file names.
A bug which caused the editor to not work if the tab stop size
did not divide the screen width has been fixed.
A bug on HP terminals that caused the screen to be messed up if
you scrolled up something that began the same way as the echo line
has been fixed.
An old ed bug which caused globals to fail when they did a substitute
on the next line has been fixed.
The % operator will now find matching square brackets the same way
it does parentheses and braces. It will not display them in
showmatch mode, however, and will not use a ] to match all ('s.
Ex looks in your environment for EXINIT. If it finds it, that
is used instead of looking for your .exrc. This should make
entry into ex faster, along with the termlib feature of looking
for a termcap entry in TERMCAP.
Internally, it is possible to turn off about a dozen different
options when compiling the editor to make it fit in 64K.
See the makefile for a list of options.
Version 2.10 -- February 2, 1980 (Corresponds to 3.3)
The default window sizes have been changed. At 300 baud the
window is now 8 lines (was 1/2 the screen size). At 1200 baud
the window is now 16 lines (was 2/3 the screen size, which was
usually also 16 for a typical 24 line CRT). At 9600 baud the
window is still the full screen size. Any baud rate less than
1200 behaves like 300, any over 1200 like 9600.
A new command mode command "x" (for "xit") has been added. This
is the same as wq but will not bother to write if there have been
no changes to the file. The command letter was chosen for
convenience and compatibilty with hed.
The command "ZZ" from vi is the same as ":x<cr>". This is
the recommended way to leave the editor. Z must be typed twice
since this is two easy to type by accident and has such severe
effects if unintentional.
The options w300, w1200, and w9600 can be set. They are synonyms
for "window", but only apply at 300, 1200, or 9600 baud, resp.
Thus you can specify you want a 12 line window at 300 baud and
a 23 line window at 1200 baud with
:set w300=12 w1200=23
The "q" command from visual no longer works at all. You must
use "Q" to get to ex command mode.
The editor no longer uses nondestructive space, except when in
insert mode. It instead prints the character it would be
moving over. This is a real win on terminals that use an
escape sequence to nd space.
A minor incompatibility with the v7 ed has been fixed. Previously,
to do a global substitute with an escaped newline in the rhs, you
had to put two \'s in ex and one in ed. Ex now accepts the single
form as well as the double form. For example, instead of
g/foo/s//foo\\
bar/g
(which still works), you can now type, as in ed,
g/foo/s//foo\
bar/g
This means that the following ex command, which used to "work":
g/foo/s//foo bar\
.+1,/mumble/d
won't work anymore unless you put the trailing / on the substitution.
This usage is pretty obscure anyway.
A bug which caused the command "g/pattern" to print an error
message if "pattern" occurred on the last line has been fixed.
Limits have been raised so that an Ann Arbor terminal can be used,
and long tags can now be accomodated.
A bug that caused HP terminals to mess up in insert mode when inserting
before a tab which follows 7 or fewer characters at the beginning of a
line (such as a tags file) has been fixed.
A bug which causes term to be displayed incorrectly and which
caused a crash when changing terminal type when there happened
to be several |'s and a long string in genbuf has been fixed.
This bug was introduced in ex 2.9.
The patch for echo lines longer than 80 characters has been
repaired to do "Hit return to continue" after such lines and
print the entire output.
A bug that caused a messed up screen after a :sh command from
open mode has been fixed.
A bug which caused a tag request for a nonexistant tag to leave
the editor in nomagic mode has been fixed.
A bug which caused strange behavior if there is no default file
name when an autowrite save is attempted has been fixed.
A bug which caused the cursor to go to the wrong position when
^^D or 0^D is entered from column 2 in autoindent mode on terminals
that can backspace has been fixed.
In order to get 2.10 to fit on a v7 pdp-11, the following features
have been deleted:
The MASTERTAGS feature (undocumented use of /usr/lib/tags
as an alternate tag file)
Checking that a file being read in is an ascii file.
Turning off ^Q/^S on a v7 system.
Version 2.9 -- November 1, 1979
The meanings of semicolon and newline, broken in 2.8, have been fixed.
Newline with two arguments still prints the range, unless a semicolon
was present, in which case only the last line is printed. Semicolon
otherwise behaves as in ed (and ex 2.7).
For compatibility with ed: '%' is an abbreviation for '1,$'.
The default starting line for 'z' is '.+1' instead of '.'.
If 'z' is followed by a number, this number is remembered
(by setting the scroll option).
The + options to the command line invocation and to the edit
command now also work for the next command. In addition, the
text after the + is no longer limited to a line number or
/ or ? search string, but can be any single command. (It cannot
contain spaces except on command line invocation, and then must
be quoted to make the shell happy.) The only special case is
where + is used by itself - this is the same as +$.
The way window sizes and scrolling commands are based on the options
window and scroll has been rearranged. All command mode scrolling
commands (z and ctrl D) are based on scroll: ^D moves scroll lines,
z moves scroll*2 lines. Everything in visual (^D, ^U, ^F, ^B, z,
window sizes in general) are based on the window option. The
defaults are arranged so that everything seems as before, but
on hardcopy terminals at 300 baud the default for scroll is
11 instead of 6.
Whether ex prompts for commands now depends on the setting of the
prompt variable, so inside script you can say 'set prompt' and
get ex to prompt.
Tags are now searched for in nomagic mode instead of the funny
mode where magic characters were impossible to get.
Paragraphs and sections with one letter names (such as those
used by PWB/MM) now work - use a space (escaped by a backslash)
for the second letter. Default paragraphs and sections are included
for both MM and MS. (Thanks to adb for this)
A bug involving 16 bit arithmetic on a vax for the yank command
has been fixed.
The text of the mailed message from expreserve has been improved
slightly.
The editor now always turns off the XTABS stty bit when in visual
mode, making terminals that do special things with ^I work.
The editor now knows about terminals with destructive tabs, like
the teleray 1061, having the xt option.
A bug that caused going past column 80 on terminals with insert line
but not insert char (like the mime, h1500, or i100) to mess up the
screen has been fixed.
A bug on 2621's that causes lines longer than 80 chars long with
embedded tabs to mess up when a tab was inserted has been fixed.
A bug that caused the wrong line to suddenly appear under very
rare circumstances involving small window sizes and long lines
where a search left the cursor on the top line of the screen
has been fixed.
The bug that caused inverse video to sometimes be scrolled up
into the file from an error message has been fixed.
The join command has been fixed, so that '3,3j' no longer joins
lines 3 and 4. ('3j' still does.) Thus, '/a/;/b/-j' works right
even if b is found on the line after a.
ex -v now finds your .exrc. In related changes, the default in
vi is now magic and nobeautify.
If your buffer is empty, ex won't refuse to do an edit, quit,
or tag command because you haven't done a write.
A bug causing visual undo not to work after '1,$!cat' has been
fixed.
Ex now decides for itself whether to use CBREAK or TIOCSETN
by whether they are defined in <sgtty.h>. This eliminates much
of the #ifdef USG or V6 lines. One USG line remains due to a bug
in the USG tty driver at 1200 baud.
Note that this will mess up if you use libretro because <sgtty.h>
has CBREAK and TIOCSETN defined. Take these out of sgtty.h to fix this.
Termcap options TI and TE have been added. These strings are
respectively output at the beginning and end of the editing session.
Values for the set command may now include `\ ' for space and
control characters.
Changes have been made to /etc/termcap (several new fields have
been added) and to termlib (it now looks for TERMCAP in the environment
and treats it as a termcap entry if the name of the terminal mentioned
is the same as TERM and the entry doesn't start with a slash.
If it starts with a slash it is treated as a filename, as before.
Termcap also checks the 512 byte entry limit and skips lines beginning
with # as comments. It is possible to define one terminal as being
similar to another one with a few differences without making two
copies of the description.) New termcap fields:
ti terminal initialization string. This should be sent
out at the beginning of any program that addresses
the cursor.
te Like te but at end of the program.
(Thanks to adb for these two fields)
us Start underlining.
ue End underlining.
uc Underline one character & move over it.
hc (bool) terminal is hardcopy
ns (bool) terminal doesn't scroll (tektronix)
ff (bool) hardcopy knows ^L means formfeed.
pt (bool) hardware tabs, maybe set by is
xt (bool) destructive tabs (teleray 1061)
ku sequence sent by keypad "up" arrow
kd "down" arrow
kl "left" arrow
kr "right" arrow
kh "home" arrow
ks sequence to make keypad send these codes
ke sequence to make keypad not send these codes.
k0-k9 sequences sent by up to 10 "other" keys
l0-l9 labels on k0-k9. If omitted, default = "f0" - "f9".
ko additional keys on keypad, in terms of their
termcap entry. For example, if "home down" and "clear"
are present and send the same codes as ll and cl, use
:ko=cl,ll:
tc This entry is a list of differences from the named
entry. THIS MUST BE THE LAST FIELD. Example: hp2621
with no ks or ke (e.g. null string):
hn|hp2621nl:ks@:ke@:tc=hp2621:
The @ cancels the string even if it is defined later.
Version 2.8 -- July 18, 1979
It is now possible to backspace over the first character (:, /, or ?)
on the echo line from visual. The effect is as though delete were hit
except the bell isn't rung.
The trailing slash in global commands is now optional.
g/pat means g/pat/p
(This change, as well as the corresponding changes to the substitute
command and r.e. address are also in the latest version of ed.)
The j, k, and l keys now move the cursor down, up, and right,
respectively, in visual mode, as they used to do (and still do on
3a's). This is to avoid the creeping of these keys into the map
descriptions of terminals and to compensate for the lack of arrow
keys on terminals like HP's.
Two arguments given to a newline command now print the range of
lines instead of just the last line (as though 'p' were appended).
To make forms like /foo/;/bar/ still work, the ; operator sets
the dot as before but then forgets everything to the left of the ;.
The + option invoked from the shell or the edit command has
two new forms: +/pat and +?pat
These cause the initial line to be chosen by a search for the
pattern pat. Note that if any special characters are in the
argument (such as ^, $, and even ?) it must be quoted.
Two new options are added: autowrite (aw) and hardtabs (ht).
Autowrite is a toggle, off by default. When on, if you have
unsaved changes before a context switching command, a write
is done automatically. The commands that may write are !,
next, and tag. Note that there is an equivalent way to do the
command with autowrite set without the write in each case:
shell, tag!, and edit do not write.
Hardtabs is a numeric option,, set to 8 by default.
Changing this to, say, 4, tells ex that either your system
expands tabs to every 4 spaces, or your terminal has hardware
tabs set every 4 spaces.
A bug that caused strange behaviour when an echo line contained
more than 79 characters (from a long : command or one or more long
filenames) has been patched by not printing any such characters
past column 79.
Handling of systems with nonstandard locations of files (where
the maintainer of ex is not a superuser and cannot create files
with names like /usr/lib/ex2.0strings or /etc/termcap) has been
improved. If the file can't be found as is, it is tried in the
current directory. If that fails, ex tries to run without it.
(Previously it bombed immediately if the error message file wasn't
in /usr/lib.)
Shell commands containing ! or % characters are no longer echoed
when in hush mode (as in 'ex -' from a shell file.)
Version 2.7 -- June 10, 1979
An inefficiency introduced in version 2.3, which increased the
amount of time spent preparing output by approximately 30 percent
has been corrected.
A bug which caused ``wrapmargin'' to work as though all hardcopy
terminals were 160 columns wide has been corrected.
A bug which caused the display to become confused after the display
of a long line at the bottom of the screen was suppressed (being
replaced temporarily by an @) has been fixed. Previously, under
some circumstances (e.g. after a put created the situation), scrolling
up of the following text would cause the display of this long
line to be skipped, so that the @ line would remain and the line
itself would not be displayed.
Version 2.6 -- June 2, 1979
A bug which prevented the first field separator in a tags file
from beginning with a blank has been fixed; if the separator
was a blank previously, the tag would not be found in the tags file.
A bug which caused the display to be messed up after a ``:''
escape which created long lines has been fixed. Previously
a substitute command which changed the last few lines on the screen
to be very long would leave the screen messed up.
A bug in display after 2 successive ``undo'' commands has been fixed.
Previously if you opened new lines on the display, and then did
2 successive undo commands, the display would be messed up after the
second undo if your terminal had insert/delete line.
A bug on intelligent terminals which caused unnecessary delete
character commands to be sent has been fixed. This occurred when
you did not have ``autoindent'' set, and opened a new line
below an existing line with tabs.
The change operations in open mode on hardcopy terminals has been
fixed. Previously there were several bugs in cursor placement
when the change extended to just before a tab character.
Several bugs in the handling of tabs in insert mode on intelligent
terminals have been fixed. Previously, tabs would often expand
incorrectly, leaving the wrong amount of white space, when an
insert occurred just before a tab.
A bug has been fixed which caused the editor to skip processing
of the ``.exrc'' file when the terminal type set in the
environment was unknown. The editor now processes ``.exrc'' in
this case.
[[A number of formatting changes have been made to the editor code
to eliminate unreasonably long lines. In addition, the code
from the Murray Hill and USG sites has been merged in conditionally,
so that all sites can compile from the same source.]]
Version 2.5 -- May 28, 1979
A bug which caused the VE sequence not to be sent when exiting
the editor via :q or :wq from visual has been fixed.
A bug which caused the command r^Q<ESC> to be weird when it
was repeated has been fixed.
The $ command now sets the column for future cursor motions to
effective infinity. Thus a `$' followed by up/down cursor motions
moves at the right margin of each line.
[[Internal: a bug in conditional compilation without the LISP
features has been fixed.]]
Several bugs relating to insert mode and intelligent terminals
have been fixed:
A bug which caused inserts on HP/DATAMEDIA like terminals to act
strangely when the material was inserted immediately before a tab
has been fixed.
A bug which caused the insertion of full tabs to not appear to
insert as many spaces as required (under strange circumstances)
has been fixed.
A bug which caused inserts on terminals with insert/delete line
but no insert/delete character to act strangely if the insert
caused a line to overflow has been fixed.
The ``expreserve'' program has been improved; you now will get
mail if a file is saved for you as a result of your phone being
hung up accidentally.
Version 2.4 -- May 19, 1979
A bug during inserts on intelligent terminals which occasionally
caused double ``~~'' characters on the last few lines of the display
rather than just single `~' characters has been fixed.
The w W b B e and E operations in visual now wrap around line
boundaries. Thus a sequence of enough w commands will get to any
word below the current position in the file, and b's will back
up to any place before. Thus these are more like the sentence
operations ( and ). You still can't back around line boundaries
duing inserts however.
Version 2.3 -- May 13, 1979
The P command to ex is now a synonym for p, so that 1,$P works,
if you don't let up on the shift key soon enough.
The / and ? operations within visual and open now hit later
(or earlier resp) occurrences of the same string on the same
line. This makes scans using / and ? much more useful. You
can move to the right on the current line by typing /pref<ESC>
where `pref' is a prefix of the word you wish to move to, and
delete to a following string `str' by doing d/str<ESC> if it is
on the same or succeeding line. Previously the command
d/pat/
deleted lines through the next line containing `pat'; it now
deletes text up to the next instance of `pat'. To delete to
the next line containing `pat', do
d/pat/0
which is short for
d/pat/+0
In general if you use an offset after the scanning pattern,
whole lines will always be affected.
Several bugs relating to the setting of the previous context mark
`` have been fixed, including one which caused operations such as
d`` or c`` to occasionally dump core. In particular, the operations
( ) { } [[ ]] and %
now set the previous context mark correctly, and the mark is set
even if the motion by these operations lands in the same line.
More optimization is now done on output cursor motions. This
is particularly much better on HP terminals which have
ridiculously long cursor addressing sequences. A new
capability has been added to the termcap file to aid this:
``bt'' (backtab). Thanks to Chuck Haley for the new code to
implement this.
A bug has been fixed on intelligent terminals which caused part
of the screen to be accidentally erased during insertions.
This occurred only on the first line on the screen, when it
became longer than one displayed line and only if a part of
the screen (at the top) was currently not in use.
A bug has been fixed which caused the command ``dp'' to be interpreted
as ``delete to register p''. This normally went unnoticed since
the ``autoprint'' option would cause the effect which the ``p'' was
forcing.
Version 2.2 -- May 6, 1979
"d)" now deletes a line if the current line is a sentence rather
than leaving an empty line.
The command
:s/str
now deletes str if it can find it; previously it was an error.
The editor now handles multiple ":" escapes correctly; previously
the screen would not be redrawn necessitating a ^L to fix it if you
gave a `:!command' to ``[Hit return to continue]''.
Recursive calls to visual from within open or visual are no longer
permitted. Previously ``:vi'' from within open mode would eventually
leave the editor in a strange state.
The %age in the status line is now correctly printed on 11's;
Previously internal 16-bit overflows often caused it to be incorrect.
The editor now ignores a ":" in front of commands.
Thus you can say ``:read foo'' within ex.
A bug which caused commands involving ]] to not be repeatable has
been fixed. Previously ``d]]'' followed by ``.'' caused an error.
"ayw now works correctly. Previously this silently did nothing.
Several bugs in "recover" and "ex -r" have been fixed. Thanks
to Andy Koenig for the fixes.
In input mode in open and visual ^V (like tenex) is now equivalent
to ^Q (which is reminiscent of ITS) superquoting the next character.
A later version of the UNIX tty driver will implement the standard for
^S ^Q handshaking and make ^Q unusable.
There are several typos on page 3 of the ``edit'' manual section:
s/move "a/delete a/
s/"a move ./put a/
/move to copy/s//delete to yank/
Version 2.1 -- April 5, 1979
Invoking ex via
ex -l
now sets "lisp" and "showmatch". This is suitable for invocations
from within Franz Lisp. If you don't like "showmatch", you can
still use "ex -l", just put the command
set noshowmatch
in your .exrc file.