Annotation of coherent/d/usr/bin/elvis/doc/virec.man, revision 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.