.TH TIB 5 " 7-Jun-1990"
.SH NAME
tib - format of tib bibliography (.ref) files
.SH SYNOPSIS
The tib bibliographic database is automatically used by 
.B tib(1),
after an INDEX file has been created with
.B tibdex(1)\fR.
The extension
.B .ref
is conventional (but not automatically supplied by Tib).

.SH DESCRIPTION

A reference
.I file
is a database file containing any
number of reference 
.I items,
separated by one or more blank lines.
Reference items consist of reference 
.I fields
which in turn
consist of data organized into field 
.I tags
and field 
.I data.
The meaning of field tags is an extension of that of 
.B bib
and is
suggested by that of 
.B refer(1).
However there are enough differences
that 
.B bib
or 
.B refer
reference files are not directly
usable with 
.B tib.
A field tag is a percent sign `\fB%\fR' in column 1
followed in column 2 by a single character.  The currently recognized
tags are listed below.  Field data begins in column 4; the data
can consist of any printable characters.  Field data can be as long as
necessary and can extend into the next line.  Lines that do not begin
with a percent sign are treated as continuation lines.  Every line
(including continuation lines) must begin in column 1.  The 
.B A, E, a, e
and 
.B \e
fields can be repeated as often
as necessary; other fields can occur at most once (more precisely the
last occurance of a field is the one used).  Fields can occur in any
order except that authors, editors, etc. are listed in order of
appearance.  Lines beginning `\fB%\e\fR' are inserted verbatim
into the output; they are assumed to be TeX instructions.  Lines in
a reference item beginning `\fB%%\fR' are comments.

.SH  FIELD TAGS
.TP 5
.B %A
Author(s) (may have multiple authors, separate 
field entry for each author in order)
.TP
.B %B
Book title
.TP
.B %C
City of publication
.TP
.B %D
Date
.TP
.B %E
Editor(s) (may have multiple editors, separate 
field entry for each editor in order)
.TP
.B %F
Special citation flag, use is governed by Tib
.B %F
command
.TP
.B %G
Government (NTIS) ordering number
.TP
.B %I
Issuer (publisher)
.TP
.B %J
Journal name or for unpublished conference report, 
the conference name
.TP
.B %K
Keys for searching, not printed out
.TP
.B %M
.I Mathematical Reviews
number
.TP
.B %N
Number of issue (journal or series)
.TP
.B %O
Other information, appended to listing
.TP
.B %P
Page numbers
.TP
.B %R
Technical report identifier
.TP
.B %S
Series title
.TP
.B %T
Title of article or book
.TP
.B %V
Volume number (journal or series)
.TP
.B %W
key words (comma separated) - used by
.B texswlist(1),
by tib only when the `-i abstract.ttx' option is used.
.TP
.B %X
Abstract - used by
.B texbib(1),
by tib only when the `-i abstract.ttx' option is used.
.TP
.B %Z
Reserved by Tib for special insertions
.TP
.B %a
Translator(s), also editor(s) of translated compilations
.TP
.B %b
Translated book title
.TP
.B %c
City of publication of translated item
.TP
.B %d
Date of translated item
.TP
.B %e
Author(s) of reviewed material; reviewers' names go in 
.B %A
fields in order
.TP
.B %i
Issuer of translated item
.TP
.B %j
Translated journal name
.TP
.B %k
Reserved for future use for secondary references
.TP
.B %l
Language of translation
.TP
.B %n
Number of translated item
.TP
.B %o
Other information, inserted after book title
.TP
.B %p
Pages of translated article
.TP
.B %r
Identifier of translated technical report
.TP
.B %s
Series of translated item
.TP
.B %t
Title of translated article or book
.TP
.B %v
Volume of translated item
.TP
.B %z
Reserved by Tib for special insertions
.TP
.B %\e
...	\".B %\\	damn nroff!
Beginning of line of TeX instruction(s)
.TP
.B %%
Comment (passed as TeX comment)

The
.B %W
.B %X
and field tags are local additions, implemented in
\fBabstract.ttx\fR.
The \fB%X\fR tag is compatible
with 
.B refer(1)
and
.B roffbib(1)\fR,
the nroff/troff analogues of
.B tib(1)
and
.B texbib(1)\fR.

.SH FILES
/vol/tex/lib/tib/inputs/abstract.ttx

.SH "SEE ALSO"
.B tib(1), tex(1), texbib(1), texswlist(1)

.B addbib(1), refer(1), roffbib(1)
.SH AUTHOR
J. C. Alexander.

Local modifications for the Institute of Theoretical Physics,
University of Cologne, by  S. Kremer.