SEE ALSO

ctags(1), ref(1), elvprsv(1), elvrec(1)

Elvis—A Clone of Vi/Ex, the complete elvis documentation.

BUGS

There is no Lisp support. Certain other features are missing, too.

Auto-indent mode is not quite compatible with the real vi. Among other things, 0^D and ^^D don't do what you might expect.

Long lines are displayed differently. The real vi wraps long lines onto multiple rows of the screen, but elvis scrolls sideways.

AUTHOR

Steve Kirkendall (kirkenda@cs.pdx.edu)

Many other people have worked to port elvis to various operating systems. To see who deserves credit, run the :version command from within elvis, or look in the system-specific section of the complete documentation.

elvprsv

elvprsv—Preserve the modified version of a file after a crash

SYNOPSIS

elvprsv ["_why elvis died"] /tmp/filename...

elvprsv -R /tmp/filename...

DESCRIPTION

elvprsv preserves your edited text after elvis dies. The text can be recovered later, via the elvprsv program.

For UNIX-like systems, you should never need to run this program from the command line. It is run automatically when elvis is about to die, and it should be run (via /etc/rc) when the computer is booted. THAT'S ALL!

For non-UNIX systems such as MS-DOS or VMS, you can either use elvprsv the same way as under UNIX systems (by running it from your AUTOEXEC.BAT file), or you can run it separately with the -R flag to recover the files in one step.

If you're editing a file when elvis dies (due to a bug, system crash, power failure, and so on), then elvprsv will preserve the most recent version of your text. The preserved text is stored in a special directory; it does not overwrite your text file automatically. (If the preservation directory hasn't been set up correctly, then elvprsv will simply send you a mail message describing how to manually run elvprsv.)

elvprsv will send mail to any user whose work it preserves, if your operating system normally supports mail.

FILES

BUGS

Due to the permissions on the /usr/preserve directory, on UNIX systems elvprsv must be run as superuser. This is accomplished by making the elvprsv executable be owned by root and turning on its "set user id" bit.

If you're editing a nameless buffer when elvis dies, then elvprsv will pretend that the file was named foo.

AUTHOR

Steve Kirkendall (kirkenda@cs.pdx.edu)

elvrec

elvrec— Recover the modified version of a file after a crash

SYNOPSIS

elvrec [preservedfile [newfile]]

DESCRIPTION

If you're editing a file when elvis dies, the system crashes, or power fails, the most recent version of your text will be preserved. The preserved text is stored in a special directory; it does not overwrite your text file automatically.

The elvrec program locates the preserved version of a given file, and writes it over the top of your text file—or to a new file, if you prefer. The recovered file will have nearly all of your changes.

To see a list of all recoverable files, run elvrec with no arguments.

FILES

BUGS

elvrec is very picky about filenames. You must tell it to recover the file using exactly the same pathname as when you were editing it. The simplest way to do this is to go into the same directory that you were editing, and invoke elvrec with the same filename as elvis. If that doesn't work, then try running elvrec with no arguments, to see exactly which pathname it is using for the desired file.

Due to the permissions on the /usr/preserve directory, on UNIX systems elvrec must be run as superuser. This is accomplished by making the elvrec executable be owned by root and setting its "set user id" bit.

If you're editing a nameless buffer when elvis dies, then elvrec will pretend that the file was named foo.

AUTHOR

Steve Kirkendall (kirkenda@cs.pdx.edu)

emacs

emacs—GNU project emacs

SYNOPSIS

emacs [ command-line switches ] [ files ... ]

DESCRIPTION

GNU emacs is a version of emacs, written by the author of the original (PDP-10) emacs, Richard Stallman.

The primary documentation of GNU emacs is in the GNU Emacs Manual, which you can read online using info, a subsystem of emacs. Please look there for complete and up-to-date documentation. This man page is updated only when someone volunteers to do so; the emacs maintainers' priority goal is to minimize the amount of time this man page takes away from other more useful projects.

The user functionality of GNU emacs encompasses everything other emacs editors do, and it is easily extensible since its editing commands are written in Lisp.

emacs has an extensive interactive help facility, but the facility assumes that you know how to manipulate emacs windows and buffers. Ctrl+h (backspace or Ctrl+h) enters the Help facility. Help Tutorial (Ctrl+h t) requests an interactive tutorial that can teach beginners the fundamentals of emacs in a few minutes. Help Apropos (Ctrl+h a) helps you find a command given its functionality, Help Character (Ctrl+h c) describes a given character's effect, and Help Function (Ctrl+h f) describes a given Lisp function specified by name.

emacs's Undo can undo several steps of modification to your buffers, so it is easy to recover from editing mistakes.

GNU emacs's many special packages handle mail reading (RMail) and sending (Mail), outline editing (Outline), compiling (Compile), running subshells within emacs windows (Shell), running a Lisp read-eval-print loop (Lisp-Interaction-Mode), and automated psychotherapy (Doctor).

There is an extensive reference manual, but users of other emacses should have little trouble adapting even without a copy. Users new to emacs will be able to use basic features fairly rapidly by studying the tutorial and using the self-documentation features.

OPTIONS

The following options are of general interest:

The following options are Lisp-oriented (these options are processed in the order encountered):

The following options are useful when running emacs as a batch editor: