% README -- Contents of the astrobib package distribution
% This file last updated April 10, 1995

Thank you for your interest in the Astrobib package for reference preparation.

Perhaps the most tedious part of preparing an article is dealing with
the references: keeping track of which have been cited and formatting
the reference section at the end of the paper in accordance with a
particular journal's requirements. This package aims to simplify this
task, while remaining compatible with the AAS/WGAS latex macros (as 
well as the latex styles distributed by A&A and MNRAS). However, because
this package uses additional style files, it is NOT compatible with 
current rules for electronic submission.

The current version should in principle run on any Unix system,
but has been tested only under SunOS so far. If you install it on
another operating system, please let us know of any problems.

This directory contains all the files in the distribution.  They are
described briefly immediately below.  Following the file descriptions
are short installation instructions, the generic recipe for printing the
user guide and samples, and information about contacting us regarding
the distribution.

README    	- This file
Makefile  	- Master installation script.
ancillary 	- Ancillary preprocessing software (ref_to_tex & getref).
	    	  See README file there for installation instructions.
bibtex    	- style files, normally installed in system-wide texinputs and 
	  	- bibinputs directories.
	  	- See README file there for known problems with the styles.
doc       	- Documentation and examples
examples  	- Basically a test suite of different forms of citations.
history   	- Modification history
inconsistencies - Description of inconsistencies in journal styles, and choices
		  made by astrobib.
known_bugs      - List of known bugs.

INSTALLATION INSTRUCTIONS:

Bibtex and latex style files:
   > cd bibtex
     edit Makefile to set BIBINPUTS and TEXINPUTS pathnames
   > make install
	
Ancillary software
   > cd ancillary/ref_to_tex
     edit Makefile to set BINDIR pathname
   > make install

   > cd ancillary/getref
     edit Makefile to set BINDIR pathname
   > make install

If you have problems using 'make,' you may copy the following files by hand:
   bibtex/*.sty	    - To system-wide or personal TEXINPUTS directory 
   bibtex/*.bst	    - To system-wide or personal TEXINPUTS directory
   bibtex/*.bib	    - To system-wide or personal BIBINPUTS directory

   ancilalrry/getref/getref        - To system-wide or local BIN directory
   ancillary/ref_to_tex/ref_to_tex - To system-wide or local BIN directory
   ancillary/ref_to_tex/makebib    - To system-wide or local BIN directory
   ancillary/ref_to_tex/makekey    - To system-wide or local BIN directory

PRINTING THE GUIDE 

The User Guide is found in the postscript file doc/astrobib.ps 
should be printed out for best results in reading it.  

The Guide is written using the aaspp substyle from the WGAS macro
package, along with the astrobib substyle and is therefore a LaTeX
document. The script 'Dotex' will process the latex file once you have
installed astrobib.

ADMINISTRATIVE DETAILS

This package has been prepared by Henry Ferguson of the Space Telescope
Science Institute in Baltimore and Ethan Bradford of the University of
Washington. Please send comments, suggestions, complaints, etc. 
to ferguson@stsci.edu.

10 Apr 1995