diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /biblio/tib/tib.man |
Initial commit
Diffstat (limited to 'biblio/tib/tib.man')
-rw-r--r-- | biblio/tib/tib.man | 191 |
1 files changed, 191 insertions, 0 deletions
diff --git a/biblio/tib/tib.man b/biblio/tib/tib.man new file mode 100644 index 0000000000..89b43674e2 --- /dev/null +++ b/biblio/tib/tib.man @@ -0,0 +1,191 @@ +.\" 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 <input file> 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) |