!BibTeX is a simple front-end for BibTeX, the bibliography tool for LaTeX. It is only useful if you have LaTeX installed. Somewhere under the !TeX directory there should be the bibtex executable, and a directory with bibliography-style (.bst) files.
This file only explains about the front-end. If you want to know what is possible with BibTeX and how it's used, you'd best look it up in Leslie Lamport's manual for LaTeX. There is some info in the Unix 'man'-page (file 'Doc' in the !BibTeX directory), but that's probably only useful for hackers.
Usage
-----
Drop a directory containing a LaTeX document from a Filer window on the iconbar icon. !BibTeX first sets the current directory to the parent of the one you dropped, and then runs bibtex in a taskwindow. Before you do, make sure that the Filer has 'seen' the !TeX application, so that bibtex (the executable) can be found. !TeX should also set variable BibInputs$Path, which bibtex needs to find the .bst and .bib (bibliography database) files. The current directory is restored to its previous setting when the task in the taskwindow exits.
Troubleshooting
---------------
!BibTeX has only been tested with the bibtex version by Graham Toal (file date 19 Jan 90), part of the ArMaTuRes package. It is also included in the distribution of ArmTeX 3.141 from Robin Watts. This is a port of bibtex v.0.99c, and it needs a large WimpSlot (1048k); if it's too small you will get an address exception.
If bibtex won't run properly then PROCrunbibtex in !RunImage is the place to look. You can alter the WimpSlot there, or make modifications to run it under !Virtual (which it currently doesn't).
If you have any problems with running !BibTeX then please let me know.
