Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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	numbers	or la-
	     bels).

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

	     .[
	     $LIST$
	     .]

	     is	 encountered,  and  then write out all references 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, 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 beginning with	the characters %x; By default,
	     x is L.

       -lm,n Instead of	numbering references, use labels from the  senior  au-
	     thor'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:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWdoc			   |
       +-----------------------------+-----------------------------+

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.9			  14 Sep 1992			      refer(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=refer&sektion=1&manpath=SunOS+5.9>

home | help