diff options
Diffstat (limited to 'usr.bin/vi/README')
| -rw-r--r-- | usr.bin/vi/README | 152 |
1 files changed, 68 insertions, 84 deletions
diff --git a/usr.bin/vi/README b/usr.bin/vi/README index a33bfc6f04c3..e46f4de58bd1 100644 --- a/usr.bin/vi/README +++ b/usr.bin/vi/README @@ -1,12 +1,13 @@ -# @(#)README 8.40 (Berkeley) 1/12/94 +# @(#)README 8.54 (Berkeley) 3/24/94 -This is the README for version 1.01 of nvi, a freely redistributable -replacement for the vi and ex text editors. It can be retrieved via -anonymous ftp from ftp.uu.net, or from ftp.cs.berkeley.edu. In the -latter, it is in the directory ucb/4bsd, and is named nvi.tar.Z. +This is the README for version 1.11 of nex/nvi, a freely redistributable +replacement for the Berkeley ex and vi text editors. The compressed tar +archive can be retrieved by anonymous ftp from ftp.cs.berkeley.edu, from +the file ucb/4bsd/nvi.tar.Z. There is a gzip'd tar archive, nvi.tar.z, +in the same directory. -If you have any questions or problems with nvi, please send them to -me by electronic mail at one of the following addresses: +If you have any questions about nvi, or problems making it work, please +contact me by electronic mail at one of the following addresses: uunet!bostic bostic@cs.berkeley.edu @@ -16,12 +17,12 @@ Keith Bostic =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= o Redistribution: -Nvi is copyrighted by the The Regents of the University of California, -but may be freely redistributed (or used to line your birdcage) under -the following conditions: +This software is copyrighted by the The Regents of the University of +California, but may be freely redistributed (or sold, or used to line +your birdcage) under the following conditions: /*- - * Copyright (c) 1994 + * Copyright (c) 1991, 1993, 1994 * The Regents of the University of California. All rights reserved. * * Redistribution and use in source and binary forms, with or without @@ -77,99 +78,82 @@ o From the original vi acknowledgements, by William Joy and Mark Horton: work on a large number of terminals and Unix systems. o And... - The financial support of UUNET Communications Services is gratefully acknowledged. =-=-=-=-=-=-=-=-=-=-= -o Comments: - -This software is beta software, although it's pretty stable. Almost -of the necessary functionality for ex/vi is in it, the only missing -pieces are fairly obscure. +o Status: -Code fixes are very much appreciated, of course, but if you can't -provide them, please send me as much information as you can as to how -to reproduce the bug, and I'll try to fix it here. In particular, the -screen routines are nasty stuff, and you probably don't want to mess -with them. Stack traces of core dumps are sometimes helpful, but an -example file with a set of keystrokes that causes the problem is far -better. +This software is in beta test, and it's believed to be pretty stable. +Almost all of the historic functionality in ex/vi is there, the missing +pieces are fairly obscure. In particular, the edcompatible, hardtabs*, +lisp*, optimize*, redraw*, and slowopen* options are recognized, but not +implemented. Nvi is mostly 8-bit clean. This isn't difficult to fix, and was left in during initial development to make things easier. Wide character support will be integrated at the same time it is made fully 8-bit clean. -=-=-=-=-=-=-=-=-=-=-= -o New features: - There aren't a lot of new features in nex/nvi, but there are a few things -you might like: - - o 8-bit clean data, practically infinite lines/files. - ^Vx[0-9A-Fa-f]* in input mode will insert any - legal character value. - o Split screens: - :sp[lit] [file ...] splits the screen. - ^W switches between screens. - :resize count grows/shrinks the current screen. - o Background/foreground screens - :bg backgrounds the current screen. - :di[splay] s[creens] lists the hidden screens. - :fg [file] foregrounds the specified (or next) screen. - o Shell screens: - :sc[ript] [file ...] runs a shell in the screen. - Carriage return sends a line to the shell. - o Buffer, screens, tags display: - :di[splay] b[uffers] displays the current cut buffers. - :di[splay] s[creens] displays the hidden screen names. - :di[splay] t[ags] displays the current tags stack. - o Tag stacks: - ^T returns to previous tag location. - :tagpop [number | file] returns to previous tag location, - or, optionally tag #N, or the tag in a specific file. - :tagtop returns to first tag location. - o Infinite undo: - A '.' command immediately after a 'u' command continues - either forward or backward depending on whether the 'u' - command was an undo or a redo. - o Usage information: - :exu[sage] [cmd] for ex commands. - :viu[sage] [key] for vi commands. - :help - o Extended RE expressions: - :set extended turns on extended RE's, so you can - do "/in|or" and search for the next occurrence of - more than one expression. - o Word search: - ^A searches for the word referenced by the cursor. - o Number increment: - # increments the number referenced by the cursor. - o Previous file: - :prev[ious][!] edits the previous file from the - argument list. +you might like. See the "ADDITIONAL FEATURES" section of the manual page +(docs/vi.0.txt, docs/vi.0.ps) for a list. =-=-=-=-=-=-=-=-=-=-= o Porting information: -The directory PORT has directories per machine/OS combination, with -V7-style Makefiles which build nvi. See the file PORT/README for -more detailed information. +The directory PORT has directories per OS/machine combination, with +V7-style Makefiles which build nex/nvi. See the file PORT/README for +detailed information. =-=-=-=-=-=-=-=-=-=-= -o Directories: +o Bug reports: + +Code fixes are appreciated, of course, but if you can't provide them, +please email me as much information as you can as to how to reproduce +the bug, and I'll try to fix it locally. In particular, the screen +routines are nasty stuff, and you probably don't want to mess with them. +Stack traces of core dumps are sometimes helpful, but an example file +with a set of keystrokes that causes the problem is far better. Also, +make sure that you include the dimensions of the screen on which the +problem occurred, your startup files (.exrc, .nexrc), and the environment +variable (EXINIT, NEXINIT) values. + +=-=-=-=-=-=-=-=-=-=-= +o Layout: + +nvi: + Source files for pieces of code that are shared by all the + editors, like searching and logging code or code translating + line numbers into requests to the dbopen(3) database code. + It also has the code for adding, deleting, and changing "records" + in the underlying database. -The main directory, nvi, contains source files for pieces of code that -are shared by all the editors, like searching and logging code or code -translating line numbers into requests to the dbopen(3) database code. -It also has the code for adding, deleting, and changing "records" in -the underlying database. +nvi/PORT: + Porting directories, one per OS/architecture combination. See + nvi/PORT/README for porting information. nvi/docs: - The nvi/docs directory has technical information about data - structures and some of the trickier parts of vi like quoting, - key mapping, input queues, and executing buffers, and a - description of how nvi does edit session recovery. + The nvi/docs directory has all of the nvi documentation: + + README -- Nvi main README file. + USD.doc -- Historic vi documentation (in roff source form). + bugs.current -- Known bugs in the current nvi implementation. + changelog -- Log of changes from version to version. + features -- Todo list, suggested features list. + internals/ + autowrite -- Vi autowrite option discussion. + gdb.script -- GDB debugging scripts. + input -- Vi maps, executable buffers, and input discussion. + quoting -- Vi quoting discussion. + structures -- Nvi internal structure description. + spell.ok -- Misspellings list for README, vi.1. + tutorial -- Historic vi tutorial + vi.0.ps -- PostScript of vi.1. + vi.0.txt -- Flat text of vi.1. + vi.1 -- Nvi man page (in roff source form). + vi.ref -- Nvi reference (in roff source form). + vi.ref.ps -- PostScript of vi.ref. + vi.ref.txt -- Flat text of vi.ref. nvi/ex: The nvi/ex directory is the ex source code. Because vi has the |