Manual Pages for UNIX Operating System command usage for man refer

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  formats  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 numbers 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 refer-
                    ences  collected  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,



SunOS 5.11          Last change: 14 Sep 1992                    1






User Commands                                            refer(1)



                    all author names are reversed.


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


     -kx            Instead of numbering references,  use  labels
                    as  specified in a reference data line begin-
                    ning with the characters %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  refer-
                    ences  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  indicat-
                    ing  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  attri-
     butes:




SunOS 5.11          Last change: 14 Sep 1992                    2






User Commands                                            refer(1)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | text/doctools               |
    |_____________________________|_____________________________|


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













































SunOS 5.11          Last change: 14 Sep 1992                    3