bib man page on 4.4BSD

Printed from http://www.polarhome.com/service/man/?qf=bib&af=0&tf=2&of=4.4BSD

BIB(1)									BIB(1)

NAME
       bib, listrefs, bibinc, bib2tib - bibliographic formatter

SYNOPSIS
       bib [options] ...
       listrefs [options] ...
       bibinc [options] ...

DESCRIPTION
       Bib  is a preprocessor for nroff or troff(1) that formats citations and
       bibliographies.	The input files (standard input default) are copied to
       the  standard  output,  except for text between [. and .]  pairs, which
       are assumed to be keywords for searching a bibliographic database.   If
       a  matching  reference  is  found a citation is generated replacing the
       text.  References are collected, optionally sorted, and written out  at
       a  location  specified by the user.  Citation and reference formats are
       controlled by the -t option.

       Reference databases are created using the invert utility.

       The following options are available.  Note that standard format	styles
       (see the -t option) set options automatically.  Thus if a standard for‐
       mat style is used the user need not indicate any	 further  options  for
       most documents.

       -aa     reduce authors first names to abbreviations.

       -arnum  reverse the first num author's names.  If a number is not given
	       all authors names are reversed.

       -ax     print authors last names in Caps-Small Caps style.  For example
	       Budd  becomes BUDD.  This style is used by certain ACM publica‐
	       tions.

       -cstr   build citations according to the template str.  See the	refer‐
	       ence format designers guide for more information on templates.

       -d      changes	the  default search directory for style files, include
	       files, etc.  and changes the value of  the  macro  BMACLIB  for
	       bib,  and  of the macro l] used to find the troff macro defini‐
	       tion file bmac.std.  Defaults  to  /usr/new/lib/bmac.   If  you
	       have  your own private copies of all the necessary files, using
	       this option is the easiest way to specify them.

       -ea     reduce editors' first names to abbreviations.

       -ex     print editors' last names in Caps-Small	Caps  style  (see  -ax
	       option).

       -ernum  reverse the first num editors' names.  If a number is not given
	       all editors' names are reversed.

       -f      instead of collecting references, dump each  reference  immedi‐
	       ately  following the line on which the citation is placed (used
	       for footnoted references).

       -i file

       -ifile  process the indicated file, such	 as  a	file  of  definitions.
	       (see technical report for a description of file format).

       -h      replace	citations  to  three  or more adjacent reference items
	       with a hyphenated string (eg 2,3,4,5 becomes 2-5).  This option
	       implies the -o option.

       -nstr   turn  off  indicated options.  str must be composed of the let‐
	       ters afhosx.

       -o      contiguous citations are ordered according  the	the  reference
	       list before being printed (default).

       -p file

       -pfile  instead	of searching the file INDEX, search the indicated ref‐
	       erence files before searching the  system  file.	  files	 is  a
	       comma  separated	 list  of  inverted indices, created using the
	       invert utility.

       -sstr   sort references according to the template str.

       -t type

       -ttype  use the standard macros and switch settings for	the  indicated
	       style to generate citations and references.  There are a number
	       of standard styles provided.  In addition  users	 can  generate
	       their  own  style  macros.   See the format designers guide for
	       details.

       -Tib    the abbreviations and macros used all  use  the	TiB  style  of
	       macro call in which the name is enclosed in vertical |bars|.

       -Tibx   instead of processing the input files, write the file bib.m4.in
	       containing m4(I) macro definitions that	make  converting  from
	       bib  style  to  Tib style macros a little easier.  Note that m4
	       does not allow ampersands in macro names: this file and all  of
	       the files to be converted will have to be changed by hand.  The
	       m4 macros will only identify  words  that  bib  would  normally
	       expand:	 they	do   no	 other	conversions.   After  creating
	       .bib.m4.in, run the scriptfile bib2tib passing it the names  of
	       the files you wish converted.

       Listrefs	 formats  an  entire  reference	 database  file.   Options  to
       listrefs are the same as for bib.

       Bibinc is an old hack tool for solving the problem of  multiple	define
       files  for  multiple  styles.  Some journal styles require that journal
       names be spelled out completely, while others allow abbreviated	names.
       Two  macro  definition files are available that allow this multiplicity
       of style: bibinc.fullnames and bibinc.shortnames.  A frequent source of
       error  is  updating  one	 of  these files, and forgetting to update the
       other.  Bibinc allows a single file, say bibinc.names, to  define  both
       the long and the short versions of names, and from which the files bib‐
       inc.fullnames and bibinc.shortnames can easily be created.  Bibinc  can
       also be used to define macro files for the TiB bibliographic preproces‐
       sor.

       Bib2tib will use the bib.m4.in file created with the  -Tibx  option  to
       convert	any  files you specify into one using the TiB-style macro con‐
       ventions.  It is a simple script that does about 95% of	the  necessary
       grunge  work  to	 make this conversion, but be aware that the user will
       still need to eyeball the converted files for correctness.  To make use
       of  the	facility,  run	a  bib job with the -Tibx option: bib will not
       process the input files, but will create bib.m4.in instead, after gath‐
       ering  together	all the definitions it can find. Then for each of your
       bibliographic database files, run bibinc.

       Bib was designed initially for use with the -ms macros, and uses a cou‐
       ple  of	the -ms macros (.ip and .lp) in its macro definitions.	To use
       it with the -me macros, prefix the file being sent to nroff/troff  with
       the following macro definitions:
		 .de IP
		 .ip \$1 \$2
		 ..
		 .de LP
		 .lp
		 ..

       A  file	"bibmac.me" containing these macro definitions may be found in
       /usr/new/lib/bmac.

FILES
       INDEX		   inverted index for reference database
       /usr/dict/papers/INDEXdefault system index
       /usr/new/lib/bmac/bmac.*formatting macro packages
       /usr/new/lib/bmac/bibinc.namesinput to bibinc
       /usr/new/lib/bmac/tibmacs/*for use with TiB-style |macros|
       /usr/new/lib/bmac/bibmacs/*for use with old bib-style macros
       /usr/tmp/bibr*	   scratch file for collecting references
       /usr/tmp/bibp*	   output of pass one of bib
       bib.m4.in	   macros for converting to TiB (see -Tibx above)

SEE ALSO
       A UNIX Bibliographic Database Facility, Timothy A.  Budd	 and  Gary  M.
       Levin,  University  of  Arizona Technical Report 82-1, 1982.  (includes
       format designers guide).
       BIB - A Program for Formatting Bibliographies, Timothy A. Budd,	a  BSD
       UNIX document found in /usr/doc/usd/31.bib.
       invert(1), troff(1)

4th Berkeley Distribution      2 September 1988				BIB(1)
[top]

List of man pages available for 4.4BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net