обрабатывать библиографические ссылки для groff (process bibliographic references for groff)
Описание (Description)
The GNU implementation of refer is part of the groff(1) document
formatting system. refer is a troff(1) preprocessor that
prepares bibilographic citations by looking up keywords specified
in a roff(7) input document, obviating the need to type such
annotations, and permitting the citation style in formatted
output to be altered independently and systematically. It copies
the contents of each file to the standard output stream, except
that it interprets lines between .[ and .] as citations to be
translated into groff input, and lines between .R1 and .R2 as
instructions regarding how citations are to be processed.
Normally, refer is not executed directly by the user, but invoked
by specifying the -R option to groff(1). If no file operands are
given on the command line, or if file is '-', the standard input
stream is read.
Each citation specifies a reference. The citation can specify a
reference that is contained in a bibliographic database by giving
a set of keywords that only that reference contains.
Alternatively it can specify a reference by supplying a database
record in the citation. A combination of these alternatives is
also possible.
For each citation, refer can produce a mark in the text. This
mark consists of some label which can be separated from the text
and from other labels in various ways. For each reference it
also outputs groff(7) language commands that can be used by a
macro package to produce a formatted reference for each citation.
The output of refer must therefore be processed using a suitable
macro package, such as me, mm, mom, or ms. The commands to
format a citation's reference can be output immediately after the
citation, or the references may be accumulated, and the commands
output at some later point. If the references are accumulated,
then multiple citations of the same reference will produce a
single formatted reference.
The interpretation of lines between .R1 and .R2 as prepreocessor
commands is a new feature of GNU refer. Documents making use of
this feature can still be processed by AT&T refer just by adding
the lines
.de R1
.ig R2
..
to the beginning of the document. This will cause troff(1) to
ignore everything between .R1 and .R2. The effect of some
commands can also be achieved by options. These options are
supported mainly for compatibility with AT&T refer. It is
usually more convenient to use commands.
refer generates .lf requests so that file names and line numbers
in messages produced by commands that read refer output will be
correct; it also interprets lines beginning with .lf so that file
names and line numbers in the messages and .lf lines that it
produces will be accurate even if the input has been preprocessed
by a command such as soelim(1).
