home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / tex / macbibtx.sit / BibTex0.99c_Readme.tex < prev    next >
Text File  |  1989-09-22  |  5KB  |  91 lines
  1. README file for MacBibTex version 1.1
  2.  
  3. This is the BibTeX 0.99c Mac Distribution Kit.
  4.  
  5. Included in this kit are the following:
  6.     BibTeX application for the mac
  7.     Source code for the BibTeX application
  8.  Bibtex 0.99c compatable style files
  9.     ResTools - a resource compiler from Alan Dahlbom
  10.     Prototype Maker - a C function prototype generator from Peter Olson
  11.  
  12. ResTools is used for compiling the resources used by the Mac application.
  13. Prototype Maker is used for converting new versions of BibTeX to the Mac,
  14. you should not need to use it unless you get a new version of BibTeX for
  15. unix.
  16.  
  17. PLEASE!!! Do not blame me for the bibtex sources.  I didn't write them.
  18. They came out of Web2C and I got them like that.
  19.  
  20. BibTeX was written with a virtual memory architecture in mind, it uses
  21. large static arrays to store its data.  These have been made into run
  22. time allocated pointers for the Mac, but they are still static.  As a
  23. result BibTeX will require 700k to run for any sized file.  This means
  24. that it will probably not run under MultiFinder on a 1 meg Mac.
  25.  
  26. THIS DISTRIBUTION IS ENTIRELY IN THE PUBLIC DOMAIN.  We insist that it remains
  27. that way.  This port was derived from public domain software. We started with
  28. Oren Patashnik's BIBTEX.WEB from Stanford and used Tim Morgan's web2c from
  29. UC-Irvine to create the base C code.  We could not have made this port without
  30. their public contributions.
  31.  
  32. Please make sure you use the 0.99c compatable style files included on this
  33. distribution.  Style files written for 0.98i Bibtex are incompatable and will
  34. result in more errors and you care to count. 
  35.  
  36. MacBibTex works as follows:
  37. (1) Double click the icon
  38. (2) You get dumped directly into a file selection menu showing only
  39.    *.aux files.  BibTex only reads *.aux files, there should be one
  40.    with the same name as your foo.tex file (eg foo.aux or foo.tex.aux)
  41.    You can also move around folders and drives in the usual MAC way.
  42. (3) If all goes well, BibTex quits quietly and dumps you back to the
  43.    desktop w/o saying a word.  The *.bbl and *.blg files have been
  44.    written in the same directory as the *.aux file.  Remember, to
  45.    get all the references properly integrated, you'll need to run
  46.    Latex ->BibTex ->Latex -> Latex.
  47. (4) If there are ANY errors or warnings, you will get a "click here
  48.    to terminate" dialog box.  This allows you to scroll through the
  49.    BibTex output window to look at the errors if you wish.  Even if you
  50.    don't look at the error message there, they are also written in 
  51.    the *.blg file that gets written each time BibTex is run.
  52.  
  53.  
  54.                                                - jim studt
  55.                                                   jim@wucs1.wustl.edu
  56.                                                - michael kahn
  57.                                                   kahn@wucs1.wustl.edu
  58.  
  59. Surface Mailing address:  Michael Kahn
  60.                                         Department of Medicine Box 8121
  61.                                         Washington University School of Medicine
  62.                                         660 S. Euclid Avenue
  63.                                         St. Louis MO 63110
  64.  
  65. PS: The icon is a stone wheel, not an aspirin.
  66.  
  67.  
  68. Version 1.1
  69. MacBibTex is smarter in looking for *.bst files.  It follows a convention
  70. similar to Textures 1.01.  To find the *.bst file, MacBibTex looks in
  71. the following locations:
  72.      (1) The current directory (where the *.aux file was located).
  73.      (2) A subdirectory called "BibTex inputs" (upper/lower case sensitive)
  74.         under the folder where the MacBibTex application is located
  75.      (3) A subdirectory called "Tex inputs" under the folder where the
  76.          MacBibTex application is located
  77.      (4) A subdirectory called "BibTex inputs" under the system folder
  78.      (5) A subdirectory called "Tex inputs" inder the system folder
  79.  
  80. With this search strategy, you can put all standard and personal *.bst files
  81. in a folder either under MacBibTex or in the system folder and MacBibTex wil
  82. find it irrespective of where your *.aux files are located.
  83.  
  84. The file searching feature is extensible because it has been implemented as
  85. a string resource (STR# resource 130).  Using a tool like Resedit, you can
  86. add or change the names of subdirectories where MacBibTex looks for *.bst files.
  87. In this resource, the number 0 refers to the directory where the *.aux file
  88. was located, the number 1 refers to the directory where MacBibTex lives, and
  89. the number 2 refers to the system folder.
  90.  
  91. Thanks and credits to John Lundell at Stanford for adding this feature.