README file for MacBibTex version 1.1

This is the BibTeX 0.99c Mac Distribution Kit.

Included in this kit are the following:
	BibTeX application for the mac
	Source code for the BibTeX application
 Bibtex 0.99c compatable style files
	ResTools - a resource compiler from Alan Dahlbom
	Prototype Maker - a C function prototype generator from Peter Olson

ResTools is used for compiling the resources used by the Mac application.
Prototype Maker is used for converting new versions of BibTeX to the Mac,
you should not need to use it unless you get a new version of BibTeX for
unix.

PLEASE!!! Do not blame me for the bibtex sources.  I didn't write them.
They came out of Web2C and I got them like that.

BibTeX was written with a virtual memory architecture in mind, it uses
large static arrays to store its data.  These have been made into run
time allocated pointers for the Mac, but they are still static.  As a
result BibTeX will require 700k to run for any sized file.  This means
that it will probably not run under MultiFinder on a 1 meg Mac.

THIS DISTRIBUTION IS ENTIRELY IN THE PUBLIC DOMAIN.  We insist that it remains
that way.  This port was derived from public domain software. We started with
Oren Patashnik's BIBTEX.WEB from Stanford and used Tim Morgan's web2c from
UC-Irvine to create the base C code.  We could not have made this port without
their public contributions.

Please make sure you use the 0.99c compatable style files included on this
distribution.  Style files written for 0.98i Bibtex are incompatable and will
result in more errors and you care to count. 

MacBibTex works as follows:
(1) Double click the icon
(2) You get dumped directly into a file selection menu showing only
   *.aux files.  BibTex only reads *.aux files, there should be one
   with the same name as your foo.tex file (eg foo.aux or foo.tex.aux)
   You can also move around folders and drives in the usual MAC way.
(3) If all goes well, BibTex quits quietly and dumps you back to the
   desktop w/o saying a word.  The *.bbl and *.blg files have been
   written in the same directory as the *.aux file.  Remember, to
   get all the references properly integrated, you'll need to run
   Latex ->BibTex ->Latex -> Latex.
(4) If there are ANY errors or warnings, you will get a "click here
   to terminate" dialog box.  This allows you to scroll through the
   BibTex output window to look at the errors if you wish.  Even if you
   don't look at the error message there, they are also written in 
   the *.blg file that gets written each time BibTex is run.


                                               - jim studt
                                                  jim@wucs1.wustl.edu
                                               - michael kahn
                                                  kahn@wucs1.wustl.edu

Surface Mailing address:  Michael Kahn
                                        Department of Medicine Box 8121
                                        Washington University School of Medicine
                                        660 S. Euclid Avenue
                                        St. Louis MO 63110

PS: The icon is a stone wheel, not an aspirin.


Version 1.1
MacBibTex is smarter in looking for *.bst files.  It follows a convention
similar to Textures 1.01.  To find the *.bst file, MacBibTex looks in
the following locations:
     (1) The current directory (where the *.aux file was located).
     (2) A subdirectory called "BibTex inputs" (upper/lower case sensitive)
        under the folder where the MacBibTex application is located
     (3) A subdirectory called "Tex inputs" under the folder where the
         MacBibTex application is located
     (4) A subdirectory called "BibTex inputs" under the system folder
     (5) A subdirectory called "Tex inputs" inder the system folder

With this search strategy, you can put all standard and personal *.bst files
in a folder either under MacBibTex or in the system folder and MacBibTex wil
find it irrespective of where your *.aux files are located.

The file searching feature is extensible because it has been implemented as
a string resource (STR# resource 130).  Using a tool like Resedit, you can
add or change the names of subdirectories where MacBibTex looks for *.bst files.
In this resource, the number 0 refers to the directory where the *.aux file
was located, the number 1 refers to the directory where MacBibTex lives, and
the number 2 refers to the system folder.

Thanks and credits to John Lundell at Stanford for adding this feature.