Unix/Linux Go Back    


OpenSolaris 2009.06 - man page for refer (opensolaris section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


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 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 references collected  so  far.  Col-
		      lapse 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 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:

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

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				   14 Sep 1992					 refer(1)
Unix & Linux Commands & Man Pages : ©2000 - 2017 Unix and Linux Forums


All times are GMT -4. The time now is 08:47 PM.