BIBINDEX(1)		  User Commands		      BIBINDEX(1)



NAME
     bibindex -	create a bibliography index file for biblook(1)

SYNOPSIS
     bibindex basename [[-i] word] [[-i] word] ...

DESCRIPTION
     bibindex creates a	compact	binary index file from	a  BibTeX
     bibliography  file	to permit fast lookup by biblook(1).  The
     basename argument can optionally omit  the	 .bib  extension.
     The  output index file will be named with the same	basename,
     and extension

     For indexing purposes, a  word  is	 any  contiguous  set  of
     letters and numbers, after	the following steps:

	  1.  Letters are folded to lower case.	 Thus,	"Voronoi"
	      is returned as "voronoi"

	  2.  All TeX commands,	except those in	math expressions,
	      are  removed,  but their arguments are left behind.
	      Thus, "Erd{\H o}ss" is returned as "erdos".

	  3.  All other	non-word characters  are  removed.   Non-
	      word  characters	inside {{possibly} nested} braces
	      or dollar	signs do not delimit words, so	they  may
	      cause  unexpected	 results.  Thus, "{this	example}"
	      is returned as "thisexample".

	  4.  TeX commands in  math  expressions  are  considered
	      normal text.  Thus, "$O(n\log^2 n)$" is returned as
	      "onlog2n"	 instead  of  "onn".   This  occasionally
	      gives  unexpected	or unreadable results.	For exam-
	      ple,  "$\bigcup_1^n[a_i,b_i]$"   is   returned   as
	      "bigcup1naibi".

	  5.  Apostrophes do not delimit words.	  Thus,	 "didn't"
	      is returned as "didnt", and "{\'O}'D{\'u}nlaing" is
	      returned as "odunlaing".

     bibindex examines the contents of	all  value  strings,  and
     expects  them  to	be well-formed TeX input.  In particular,
     braces and	dollar signs should be balanced.

     Errors detected result in a message giving	the  line  number
     of	the BibTeX entry in which the error was	detected, and the
     line number at the	point of the error.  Unbalanced	braces or
     dollar  signs  can	result in large	differences between these
     line numbers; in such a case, the error is	somewhere in  the
     entry indicated by	the first line number.





Version	2.2	  Last change: 03 October 1992			1






BIBINDEX(1)		  User Commands		      BIBINDEX(1)



OPTIONS
     -i	keyword
	 Add keyword to	the list of BibTeX keywords that  are  to
	 be ignored, along with	their string values, in	preparing
	 the index.  By	default, all keyword = "value" pairs  are
	 indexed.   Any	number of -i switches and keywords may be
	 specified.

SEE ALSO
     bibclean(1), biblook(1), bibtex(1), latex(1), tex(1)

AUTHOR
     Jeff Erickson
     Computer Science Division
     University	of California
     Berkeley, CA 94720
     USA
     Email: <jeff@cs.berkeley.edu>, <jeffe@melody.berkeley.edu>

     This program is in	the public domain.  You	 may  use  it  or
     modify it to your heart's content,	at your	own risk.


































Version	2.2	  Last change: 03 October 1992			2