The "pub/catalog" directory contains the following files:

Makefile	UNIX makefile to compile the catalog software
README		The file you are now reading
ascat1.dat	Machine-readable version of the pulsar catalog
ascat1.def	Include file for rdascat1.f
bincat.f	Converts catalog to binary for faster reading
cra.f		Some utility subroutines
psrcat.tar.Z	Compressed tarfile containing all the other files
psrcat1.def	Include file for rdascat1.f
pulsar.f	Provides catalog information on specific pulsars
rdascat.f	Subroutine used to read file ascat1.dat
rdascat.h	Include file with definition of common block
rdascat.info	Definitions and units of catalog parameters
rdascat1.f	Alternative subroutine for reading ascat1.dat
rdbincat.f	Subroutine used to read binary file bincat.dat
summary.f	Provides summary of catalog contents by various categories

The preferred method of downloading the pulsar catalog and
compiling the software on a UNIX system is:

	% ftp pulsar.princeton.edu	(or ftp 128.112.131.69)
	Name: anonymous
	Password: <your e-mail address>
	ftp> cd pub/catalog
	ftp> binary
	ftp> get psrcat.tar.Z
	ftp> quit
	% uncompress psrcat.tar
	% tar xf psrcat.tar
	% make all

On non-UNIX machines (e.g., VMS) you can forget the makefile and
the tarfile, and instead "get" each of the other files:

	$ ftp pulsar.princeton.edu
	Name: anonymous
	Password: <your e-mail address>
	ftp> cd pub/catalog
	ftp> get ascat.dat
	ftp> get cra.f
	ftp> get pulsar.f
	ftp> get rdascat.f
	ftp> get rdascat.h
	ftp> get rdascat.info
	ftp> get summary.f
	ftp> quit
	$

Then compile the FORTRAN as you usually would.

Two example programs are provided.  The first, called pulsar, allows 
you to interrogate the database for information on a particular pulsar.  
Try typing, e.g.,

	% pulsar 1913+16

to get information on a single pulsar, or type "pulsar" with no
argument to get repeated prompts asking for pulsar names.  Names may 
optionally include a leading "B" or "J"; in the absence of either,
B1950 names are assumed.

The second example program, called summary, reports the number of 
catalog entries in 31 different categories.

We hope you find the pulsar database useful.  Please send us your 
comments, corrections, suggestions, etc.

J. H. Taylor, Physics Department, Princeton University
R. N. Manchester, Australia Telescope National Facility
A. G. Lyne, Nuffield Radio Astronomy Laboratories, University of Manchester
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
                            Revision History
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Jan 29, 1993: Original distribution version deposited in pub/catalog
Mar 10, 1993: Small bug fixes and enhancements in ascat1.dat, as well as in
	      most of the associated programs.  Added binary file handling
	      for faster catalog access.