Annotation of coherent/d/usr/bin/elvis/doc/virec.man, revision 1.1.1.1

1.1       root        1: .TH VIREC v1.4
                      2: .SH NAME
                      3: virec - Recover the modified version of a file after a crash
                      4: .SH SYNOPSIS
                      5: .nf
                      6: \fBvirec\fP [\fB-d\fP \fItmpdir\fP] \fItextfilename...\fP
                      7: \fBvirec\fP </tmp/elv\fIXXX\fP
                      8: .fi
                      9: .SH DESCRIPTION
                     10: \fIVirec\fP is a program which extracts the most recent version of a
                     11: text file from a temporary file in /tmp.
                     12: .PP
                     13: When you edit a file with Elvis,
                     14: only about 5K bytes of the file are stored in RAM;
                     15: the rest is stored in a file in /tmp.
                     16: This allows you to edit files larger than a process' data space.
                     17: It also plays a big part in the way that "undo" and "paste" were implemented.
                     18: .PP
                     19: The \fIvirec\fP program basically extracts the "undo" version from the file.
                     20: This is most useful when the system (or Elvis) crashes in
                     21: the middle of a long edit session,
                     22: since the "undo" version of the file contains everything
                     23: except your last change.
                     24: Nearly all of your work can be salvaged.
                     25: .PP
                     26: The most common way to invoke virec is this:
                     27: You just give virec the name of the file you were editing,
                     28: and it finds the matching file in /tmp and writes
                     29: the newest available version of the file over the existing version.
                     30: It then deletes the /tmp file.
                     31: .PP
                     32: The other way, where you redirect its stdin to come from
                     33: a particular /tmp file, is used when you have
                     34: either forgotten which file that is and you want to see its contents,
                     35: or when you want to recover the file
                     36: without losing either the /tmp file or the current version of the text file.
                     37: .SH OPTIONS
                     38: .IP "\fB-d\fP \fItmpdir\fP"
                     39: If your \fI.exrc\fP or \fI$EXINIT\fP causes Elvis to store temp files in
                     40: a non-standard directory
                     41: (usually, anyplace other than /tmp),
                     42: then you must tell \fIvirec\fP which directory to look in.
                     43: .SH FILES
                     44: .IP /tmp/elv*
                     45: The temporary file left over from when Elvis was editing a text file.
                     46: .SH AUTHOR
                     47: .nf
                     48: Steve Kirkendall
                     49: [email protected]
                     50: \&...uunet!tektronix!psueea!eecs!kirkenda
                     51: .fi

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.