


BIBORDER(1)		  User Commands		      BIBORDER(1)



NAME
     biborder -	order key fields in a BibTeX bibliography file

SYNOPSIS
     biborder [-bimonthly m1/m2/m3/m4/m5/m6] [-check-missing]
	      [-monthly] [-quarterly m1/m2/m3/m4]
	      <	infile > outfile
     or
     biborder [-bimonthly m1/m2/m3/m4/m5/m6] [-check-missing]
	      [-monthly] [-quarterly m1/m2/m3/m4]
	      BibTeXfile(s) > outfile

DESCRIPTION
     biborder filters  one  or	more  BibTeX  bibliographies,  or
     bibliography  fragments,  from  the specified files, or from
     its standard input	if no filenames	are provided, printing on
     standard output a bibliography in which key fields	have been
     put into a	standard order:	 author, editor, key,  booktitle,
     title,  crossref,	chapter,  journal,  volume, type, number,
     howpublished, institution,	organization, publisher,  school,
     address,  edition,	 pages,	 month,	 year,	ISBN, ISSN, LCCN,
     note, price, series, and URL.  All	other key fields are out-
     put in alphabetical order following the standard ones.

     A consistent key field order makes	BibTeX entries easier  to
     read,  and	 also  facilitates  identification and removal of
     duplicates, such as with bibsort -u.

OPTIONS
     Command-line options may be abbreviated to	a unique  leading
     prefix.

     To	avoid confusion	with options, if a filename begin with	a
     hyphen,  it must be disguised by a	leading	absolute or rela-
     tive directory path, e.g.	/tmp/-foo.bib or ./-foo.bib.

     -bimonthly	m1,m2,m3,m4,m5,m6
		      If this option is	 specified,  all  of  the
		      journals	in  the	 BibTeX	 file entries are
		      assumed to appear	at  two-month  intervals.
		      The six month names that correspond to each
		      such interval must be  given  as	a  single
		      argument	following   - bimonthly, with the
		      names separated by  (any	number	of)  non-
		      letters.	 A  typical  example  is feb-apr-
		      jun-aug-oct-dec,	specifying   that   issue
		      number  1	appears	in February, and number	6
		      in December.

     - check-missing	If  this  option  is  specified,  missing
		      expected	key fields will	be supplied, with
		      the key field name prefixed with	OPT,  and



Version	0.06	  Last change: 04 December 1994			1






BIBORDER(1)		  User Commands		      BIBORDER(1)



		      the  value string	set to a pair of question
		      marks, e.g.
			OPTvolume =    "??",
		      The OPT prefix  ensures  that  the  key  is
		      ignored  by  BibTeX,  so	that the question
		      marks will not appear  in	 an  output  .bbl
		      file.   The  GNU	Emacs bibtex-mode editing
		      support has functions for	removing the  OPT
		      prefixes,	and so does bibclean(1).

		      The  doubled  question   marks   are   dis-
		      tinguished from single ones that might leg-
		      itimately	appear in value	strings, and also
		      serve  as	 a  convenient regular-expression
		      pattern for  bibextract(1),  allowing  easy
		      preparation  of  a  printed listing of just
		      those entries that have incomplete  biblio-
		      graphic data:
			   bibextract '' '[?][?]' BibTeXfiles |	 lpr

     -monthly	       If this option is specified,  all  of  the
		      journals	in  the	 BibTeX	 file entries are
		      assumed to appear	monthly, 1 in January,	2
		      in February, ...,	12 in December.

		      If only one of the number	and month  values
		      is supplied, biborder will supply	the other
		      automatically, but will name it OPTmonth or
		      OPTnumber	 to  distinguish it from existing
		      keys.  A simple editor string substitution,
		      or  bibclean(1), can subsequently	normalize
		      the appearance.

     -quarterly	m1,m2,m3,m4
		      If this option is	 specified,  all  of  the
		      journals	in  the	 BibTeX	 file entries are
		      assumed to appear	quarterly. The four month
		      names  that correspond to	each quarter must
		      be given as a single argument following	-
		      quarterly, with the names	separated by (any
		      number of) non-letters.  Some examples  are
		      jan-apr-jul-oct,	      mar////jun.sep:dec,
		      Spring\ Summer\ Fall\ Winter,  and  'Spring
		      Summer Fall Winter'.  The	last two examples
		      show that	when space separators  are  used,
		      they  must be backslashed, or else the list
		      must be surrounded by quotes, to force UNIX
		      shells  to interpret the quarter names as	a
		      single argument.

     The options -bimonthly, -monthly, and -quarterly  are  mutu-
     ally exclusive; biborder will refuse to run if more than one



Version	0.06	  Last change: 04 December 1994			2






BIBORDER(1)		  User Commands		      BIBORDER(1)



     of	them is	specified; they	should normally	only be	 used  in
     journal-specific  bibliographies, since number-month pairing
     does not hold for all journals.

     Failure to	supply the correct number of month names  for	-
     bimonthly	or  -quarterly will also cause immediate termina-
     tion.

WARNING	AND ERROR MESSAGES
     biborder will issue warning messages in the following cases:

     o	With -check-missing, for unrecognized BibTeX entry types.
       The  entry will be output without checking for missing key
       names.

     o	With -bimonthly, -monthly, and -quarterly, for mismatches
       between	month  and  number values, or for an out-of-range
       number value.

     o	For duplicate key names.  Such key/value pairs are sorted
       together	by name, preserving their original order.

     biborder will issue an error message and terminate	with exit
     code 1, and incomplete output, in the following cases:

     o	For an unrecognized command-line argument (only	the first
       letter of each option is	currently examined).

     o	If more	than one of -bimonthly,	-monthly, and -	quarterly
       is specified.

     o	End-of-file is reached while collecting	an entry.

     o	A line beginning with `@' is encountered while collecting
       an entry, before	balanced braces	have been found.

     o	An incorrect number of month names is specified	 with	-
       bimonthly or -quarterly.

CAVEATS
     BibTeX has	loose syntactical requirements that  the  current
     simple implementation of biborder does not	support.  In par-
     ticular, outer parentheses	may  not  be  used  in	place  of
     braces  following ``@keyword'' patterns.  If you have such	a
     file, you can use bibclean(1) to prettyprint it into a  form
     that biborder can handle successfully.

SEE ALSO
     bibclean(1),  bibextract(1),  biblex(1),  bibparse(1),  bib-
     sort(1), bibtex(1), bibunlex(1), emacs(1).





Version	0.06	  Last change: 04 December 1994			3






BIBORDER(1)		  User Commands		      BIBORDER(1)



AUTHOR
     Nelson H. F. Beebe, Ph.D.
     Center for	Scientific Computing
     Department	of Mathematics
     University	of Utah
     Salt Lake City, UT	84112
     Tel: +1 801 581 5254
     FAX: +1 801 581 4148
     Email: <beebe@math.utah.edu>














































Version	0.06	  Last change: 04 December 1994			4



