.\" Manual documentation for Tib reference formatting programs .TH TIB 1 "2/14/86" .fi .SH NAME tib, tibdex, tiblook, tiblist \- process reference and citation entries for TeX documents .SH SYNOPSIS .sp1 .in -5 .pp \fBtib\fR [-d <\fIdirectory\fR>] [-i <\fIinclude file\fR>] [-j] [-n <\fIinitial citation number\fR>] [-p <\fIprivate index file(s)\fR>] [-s <\fIstyle file\fR>] [-x] [-z] [-|] [<\fIinput file(s)\fR>] .sp1 .pp \fBtibdex\fR [-c <\fIcommon-word file\fR>] [-k <\fIkey number\fR>] [-l <\fIlength of keys\fR>] [-p <\fIprivate output file\fR>] [-z] [-% <\fIstring\fR>] <\fIreference file(s)\fR> .sp1 .pp \fBtiblist\fR [-d <\fIdirectory\fR ][-i <\fIinclude file\fR>] [-s <\fIstyle file\fR>] [-x] [-z] [-|] [<\fIreference file(s)\fR>] .sp1 .pp \fBtiblook\fR [-c <\fIcommon-words file\fR>] [-l <\fIlength of keys\fR>] [-p <\fIprivate indices\fR>] [<\fIkeyword1 keyword2 ...\fR>] .sp1 .SH DESCRIPTION .pp There are four programs in the Tib package: .sp 1 .in +.5 .ta 1in Tib bibliographic preprocessor for TeX documents, .br Tibdex makes inverted index from database(s), .br Tiblist lists all members of the database(s), .br Tiblook locates listings in the database(s). .in -.5 .sp 1 .in +3 \fITib\fR is a program to construct a bibliography for a TeX file and to include calls to macros files so that TeX formats the citations and bibliography in any of a number of styles. The \fIinput file\fR is a TeX file augmented with incomplete or keyed citations surrounded by Tib escape characters. Multiple input files are separated by spaces on the call and amalgamated into one output file. If <\fIinput file\fR> is omitted, one prompt is given. If the input file is named \fIfile\fR or \fIfile.tex\fR, the output file is named \fIfile-t.tex\fR, unless the input file is \fIstdin\fR, in which case the output file is \fIstdout\fR. The following are the options: .sp 1 .in +3 \fB-d\fR <\fIdirectory\fR> Private directory of tib files. \fB-i\fR <\fIfiles\fR> Include files of macros and tib commands. This option is used if there are private macro/command files. \fB-j\fR Process files called by the TeX input command. \fB-n\fR <\fInumber\fR> Nonnegative integer to initialize citations. \fB-p\fR <\fIfiles\fR> Private index files, separated by commas. The default is the file \fIINDEX\fR in the working directory. \fB-s\fR <\fIfile\fR> Style file, which contains formatting instructions and also may call other files. \fB-x\fR Output to \fIstdout\fR. \fB-z\fR Silent run. Informational (but not warning or error) messages are suppressed. \fB-|\fR Pipe. Input is \fIstdin\fR; output is \fIstdout\fR. Silent. .in -3 .sp 1 \fITibdex\fR makes an inverted index from reference file(s). Multiple reference files are separated by spaces. The output is an inverted index for use by Tib and Tiblist. The output index must not be moved or the links to the reference files will be broken. The following are the options: .in+3 .sp1 \fB-c\fR <\fIfile\fR> Common-word list, one word per line. Common words are not used as keys (default CCCCC). \fB-k\fR <\fInumber\fR> Maximum number of keys kept per record (default 100). \fB-l\fR <\fInumber\fR> Maximum length of keys (default 6) \fB-p\fR <\fIfile\fR> Private output file (default \fIINDEX\fR in the current directory). \fB-z\fR Silent run. Informational (but not warning and error) messages are suppressed. \fB-%\fR <\fIstring\fR> Ignore lines in the reference file that begin with %x where x is in the string (default CNOPVcnopv\\ ). .in -3 .sp 1 \fITiblist\fR makes a formatted TeX file of all entries in the input reference file(s). Multiple files are separated by spaces. If is omitted, one prompt is given. Unlike Tib, Tib list does not use inverted indices, but operates directly on the reference files. The following are the options: .sp 1 .in +3 \fB-d <\fIdirectory\fR> Private directory of tib files. \fB-i <\fIfiles\fR> Include files of macros and tib commands. This option is used if there are private macro/command files. \fB-s\fR <\fIfile\fR> Style file, which contains formatting instructions and also may call other files. \fB-x\fR Output to \fIstdout\fR. \fB-z\fR Silent run. Informational (but not warning and error) messages are suppressed. \fB-|\fR Pipe. Input is \fIstdin\fR; output is \fIstdout\fR. Silent. .in -3 .sp 1 Note: the \fB-p\fR option does not cause an error, but is ignored. .br .sp 1 \fITiblook\fR locates entries in reference files from keywords entered at the terminal. If keywords are entered on the command line, it operates noninteractively, otherwise it gives instructions for interactive use. Tiblook, like Tib, works through inverted indices to get to the reference files. .sp 1 The following are the options: .sp 1 .in +3 \fB-c\fR <\fIfile\fR> Common-word list, one word per line. Common words are not used as keys (default CCCCC). \fB-l\fR <\fInumber\fR> Maximum length of keys (default 6). \fB-p\fR <\fIfiles\fR> Private index files, separated by commas. The default is the file \fIINDEX\fR in the working directory. .in -6 .SH STYLES .sp 1 .in +3 There are a number of styles (called with the -s option) available. See the full documentation or the file AAAAA/Styles. .in -3 .SH FILES AND DIRECTORIES .sp 1 .ta 2in .in +3 AAAAA directory for Tib documentation .br BBBBB directory for Tib macros .br CCCCC Tib file of common words .br FFFFF Tib system index .br EEEEE source directory .in -3 .SH AUTHOR .sp 1 .in +3 .nf James C. Alexander .in -3 .fi .SH ACKNOWLEDGEMENTS .sp 1 .in +2 Tib is based on the \fInroff/troff\fR bibliography system \fIbib\fR by T. A. Budd of the University of Arizona, which in turn was inspired by the system \fIrefer\fR. Certain files used by Tib are supplied by \fIMathematical Reviews\fR. The material in these files is copyright by \fIMathematical Reviews\fR. .in -2 .SH SEE ALSO .sp 1 .in +1 AAAAA/intro.tib \- a brief introduction .br AAAAA/tibdoc.tex. \- full documentation: a plain TeX file .br AAAAA/Styles \- available styles .br .sp 1 tex(1), latex(1), bib(1), refer(1)