man.sh

操作系统源代码

XFor non-UNIX systems such as MS-DOS, you can either use \fIelvprsv\fP
Xthe same way as under UNIX systems (by running it from your AUTOEXEC.BAT file),
Xor you can run it separately with the "-R" flag to recover the files
Xin one step.
X.PP
XIf you're editing a file when \fIelvis\fP dies
X(due to a bug, system crash, power failure, etc.)
Xthen \fIelvprsv\fP will preserve the most recent version of your text.
XThe preserved text is stored in a special directory; it does NOT overwrite
Xyour text file automatically.
X.PP
X\fIelvprsv\fP will send mail to any user whose work it preserves,
Xif your operating system normally supports mail.
X.SH FILES
X.IP /tmp/elv*
XThe temporary file that \fIelvis\fP was using when it died.
X.IP /usr/preserve/p*
XThe text that is preserved by \fIelvprsv\fP.
X.IP /usr/preserve/Index
XA text file which lists the names of all preserved files, and the names
Xof the /usr/preserve/p* files which contain their preserved text.
X.SH BUGS
X.PP
XDue to the permissions on the /usr/preserve directory, on UNIX systems
X\fIelvprsv\fP must be run as superuser.
XThis is accomplished by making the \fIelvprsv\fP executable be owned by "root"
Xand turning on its "set user id" bit.
X.PP
XIf you're editing a nameless buffer when \fIelvis\fP dies, then \fIelvprsv\fP will pretend
Xthat the file was named "foo".
X.SH AUTHOR
X.nf
XSteve Kirkendall
[e-mail]
X.fi
/
echo x - elvrec.man
sed '/^X/s///' > elvrec.man << '/'
X.TH ELVREC 1
X.SH NAME
Xelvrec - Recover the modified version of a file after a crash
X.SH SYNOPSIS
X.nf
X\fBelvrec\fP [\fIpreservedfile\fP [\fInewfile\fR]]
X.fi
X.SH DESCRIPTION
X.PP
XIf you're editing a file when \fIelvis\fP dies, the system crashes, or power fails,
Xthe most recent version of your text will be preserved.
XThe preserved text is stored in a special directory; it does NOT overwrite
Xyour text file automatically.
X.PP
XThe \fIelvrec\fP program locates the preserved version of a given file,
Xand writes it over the top of your text file -- or to a new file, if you prefer.
XThe recovered file will have nearly all of your changes.
X.PP
XTo see a list of all recoverable files, run \fIelvrec\fP with no arguments.
X.SH FILES
X.IP /usr/preserve/p*
XThe text that was preserved when \fIelvis\fP died.
X.IP /usr/preserve/Index
XA text file which lists the names of all preserved files, and the names
Xof the /usr/preserve/p* files which contain their preserved text.
X.SH BUGS
X.PP
X\fIelvrec\fP is very picky about filenames.
XYou must tell it to recover the file using exactly the same pathname as
Xwhen you were editing it.
XThe simplest way to do this is to go into the same directory that you were
Xediting, and invoke \fIelvrec\fP with the same filename as \fIelvis\fP.
XIf that doesn't work, then try running \fIelvrec\fP with no arguments,
Xto see exactly which pathname it is using for the desired file.
X.PP
XDue to the permissions on the /usr/preserve directory, on UNIX systems
X\fIelvrec\fP must be run as superuser.
XThis is accomplished by making the \fIelvrec\fP executable be owned by "root"
Xand setting its "set user id" bit.
X.PP
XIf you're editing a nameless buffer when \fIelvis\fP dies, then \fIelvrec\fP
Xwill pretend that the file was named "foo".
X.SH AUTHOR
X.nf
XSteve Kirkendall
[e-mail]
X.fi
/
echo x - fmt.man
sed '/^X/s///' > fmt.man << '/'
X.TH FMT 1
X.SH NAME
Xfmt - adjust line-length for paragraphs of text
X.SH SYNOPSIS
X\fBfmt\fP [\-\fIwidth\fP] [\fIfiles\fP]...
X.SH DESCRIPTION
X\fIfmt\fR is a simple text formatter.
XIt inserts or deletes newlines, as necessary, to make all lines in a
Xparagraph be approximately the same width.
XIt preserves indentation and word spacing.
X.PP
XThe default line width is 72 characters.
XYou can override this with the \-\fIwidth\fR flag.
XIf you don't name any files on the command line,
Xthen \fIfmt\fR will read from stdin.
X.PP
XIt is typically used from within \fIvi\fR to adjust the line breaks
Xin a single paragraph.
XTo do this, move the cursor to the top of the paragraph,
Xtype "!}fmt", and
Xhit <Return>.
X.SH AUTHOR
X.nf
XSteve Kirkendall
[e-mail]
X.fi
/
echo x - ref.man
sed '/^X/s///' > ref.man << '/'
X.TH REF 1
X.SH NAME
Xref - Display a C function header
X.SH SYNOPSIS
X\fBref\fR [-t] [-c \fIclass\fR]... [-f \fIfile\fR]... \fItag\fR
X.SH DESCRIPTION
X\fIref\fP quickly locates and displays the header of a function.
XTo do this, \fIref\fR
Xlooks in the "tags" file for the line that describes the function, and then 
Xscans the source file for the function.
XWhen it locates the function, it displays an introductory comment
X(if there is one), the function's declaration, and the declarations of all
Xarguments.
X.SH "SEARCH METHOD"
X.PP
X\fIref\fR uses a fairly sophisticated tag look-up algorithm.
XIf you supply a filename via \fB-f\fR \fIfile\fR, then elvis first scans
Xthe tags file for a static tag from that file.
XThis search is limited to the tags file in the current directory.
X.PP
XIf you supply a classname via \fB-c\fR \fIclass\fR, then elvis searches
Xfor a tag from that class.
XThis search is not limited to the current directory;
XYou can supply a list of directories in the environment variable \fITAGPATH\fR,
Xand \fIref\fR will search through the "tags" file in each directory until it finds
Xa tag in the desired class.
X.PP
XIf that fails, \fIref\fR will then try to look up an ordinary global tag.
XThis search checks all of the directories listed in \fITAGPATH\fR, too.
X.PP
XIf you've given the \fB-t\fR flag, then \fIref\fR will simply output the tag line that
Xit found, and then exit.
XWithout \fB-t\fR, though, \fIref\fR will search for the tag line.
XIt will try to open the source file, which should be in the same directory
Xas the tags file where the tag was discovered.
XIf the source file doesn't exist, or is unreadable, then \fIref\fR will try to open
Xa file called "\fIrefs\fR" in that directory.
XEither way, \fIref\fR will try to locate the tag, and display whatever it finds.
X.SH "INTERACTION WITH ELVIS"
X.PP
X\fIref\fP is used by \fIelvis\fR' shift-K command.
XIf the cursor is located on a word such as "splat", in the file "foo.c",
Xthen \fIelvis\fR will invoke \fIref\fR with the command "ref -f foo.c splat".
X.PP
XIf \fIelvis\fR has been compiled with the -DEXTERNAL_TAGS flag, then \fIelvis\fR will
Xuse \fIref\fR \fB\fRto scan the tags files.
XThis is slower than the built-in tag searching, but it allows \fIelvis\fR to access
Xthe more sophisticated tag lookup provided by \fIref\fR.
XOther than that, external tags should act exactly like internal tags.
X.SH OPTIONS
X.IP \fB-t\fR
XOutput tag info, instead of the function header.
X.IP "\fB-f\fR \fIfile\fR"
XThe tag might be a static function in \fIfile\fR.
XYou can use several -f flags to have \fIref\fR consider static tags from more than one file.
X.IP "\fB-c\fR \fIclass\fR"
XThe tag might be a member of class \fIclass\fR.
XYou can use several -c flags to have \fIref\fR consider tags from more than one class.
X.SH FILES
X.IP \fBtags\fR
XList of function names and their locations, generated by \fIctags\fR.
X.IP \fBrefs\fR
XFunction headers extracted from source files (optional).
X.SH ENVIRONMENT
X.IP \fBTAGPATH\fR
XList of directories to be searched.
XThe elements in the list are separated by either
Xsemicolons (for MS-DOS, Atari TOS, and AmigaDos), or
Xby colons (every other operating system).
XFor each operating system, \fIref\fR has a built-in default which is probably
Xadequate.
X.SH NOTES
X.PP
XYou might want to generate a "tags" file the directory that contains the
Xsource code for standard C library on your system.
XIf licensing restrictions prevent you from making the library source readable
Xby everybody, then you can have \fIctags\fR generate a "refs" file,
Xand make "refs" readable by everybody.
X.PP
XIf your system doesn't come with the library source code, then perhaps you
Xcan produce something workable from the \fIlint\fR libraries.
X.SH "SEE ALSO"
Xelvis(1), ctags(1)
X.SH AUTHOR
X.nf
XSteve Kirkendall
[e-mail]
X.fi
/