unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

refer(1)                         User Commands                        refer(1)



NAME
       refer - expand and insert references from a bibliographic database

SYNOPSIS
       refer  [-ben]  [-ar]  [-cstring]  [-kx]  [-lm,n] [-p filename] [-skeys]
       filename...

DESCRIPTION
       refer is a preprocessor for nroff(1), or troff(1), that finds and  for-
       mats references. The input files (standard input by default) are copied
       to the standard output, except for lines between `.[' and `.]'  command
       lines,  Such  lines  are assumed to contain keywords as for lookbib(1),
       and are replaced by information from a bibliographic  data  base.   The
       user  can avoid the search, override fields from it, or add new fields.
       The reference data, from whatever source, is assigned to a set of troff
       strings.   Macro  packages  such  as ms(5) print the finished reference
       text from these strings.  A flag is placed in the text at the point  of
       reference. By default, the references are indicated by numbers.

       When  refer  is used with eqn(1), neqn, or tbl(1), refer should be used
       first in the sequence, to minimize the volume of  data  passed  through
       pipes.

OPTIONS
       -b              Bare mode -- do not put any flags in text (neither num-
                       bers or labels).



       -e              Accumulate references instead of leaving the references
                       where encountered, until a sequence of the form:



                       .[
                       $LIST$
                       .]




                       is  encountered, and then write out all references col-
                       lected so far. Collapse references to the same source.



       -n              Do not search the default file.



       -ar             Reverse the first r author names (Jones, J. A.  instead
                       of J. A. Jones).  If r is omitted, all author names are
                       reversed.



       -cstring        Capitalize (with SMALL CAPS) the fields whose  key-let-
                       ters are in string.



       -kx             Instead  of  numbering references, use labels as speci-
                       fied in a reference data line beginning with the  char-
                       acters %x; By default, x is L.



       -lm,n           Instead  of  numbering  references, use labels from the
                       senior author's last name and the year of  publication.
                       Only  the first m letters of the last name and the last
                       n digits of the date are used.  If either of m or n  is
                       omitted,  the  entire  name  or  date, respectively, is
                       used.



       -p filename     Take the next argument as a file of  references  to  be
                       searched.  The default file is searched last.



       -skeys          Sort  references by fields whose key-letters are in the
                       keys string, and permute reference numbers in the  text
                       accordingly.  Using  this option implies the -e option.
                       The key-letters in keys may be  followed  by  a  number
                       indicating how many such fields are used, with a + sign
                       taken as a very large number.  The default is AD, which
                       sorts  on  the  senior author and date.  To sort on all
                       authors and  then  the  date,  for  instance,  use  the
                       options `-sA+T'.



FILES
       /usr/lib/refer          directory of programs



       /usr/lib/refer/papers   directory  of  default  publication  lists  and
                               indexes



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWdoc


SEE ALSO
       addbib(1), eqn(1), indxbib(1), lookbib(1), nroff(1), roffbib(1),  sort-
       bib(1), tbl(1), troff(1), attributes(5)



SunOS 5.10                        14 Sep 1992                         refer(1)