README for the FITSIO routines.

This directory contains a streamlined version of the FITSIO routines
that is useful for unix platforms. The original distribution, with
full documentation, is in the Pe_FITSIO directory.  Also in Pe_FITSIO
is a pair of Makefiles from Steve Allen of Lick Observatory useful for
unix compiles, from which the Makefile in this directory was hacked.
If you on a VMS machine or a PC or something, the files for you are in
Pe_FITSIO.

Files beginning with Pe_ are named for William Pence, their author.

-----------------------------
1. To make the object library "libfitsio.a"

If you are on a Sun, copy this directory to your own disk space.
Then type 'mv Wo_Makefile Makefile' and type 'make.' If you are
Solaris, either ignore the error message you get about ranlib or edit
the Makefile.

------------------------------
2. FILES

There are about 290 fortran (Pe_ft*.f) files, and

Wo_Makefile          the makefile
Wo_README            this file
Wo_chname            a script to change filenames recursively throughout
                     a directory. For instance, 
                     'chname Pe_ft ft' will strip off all of the Pe_
                     prefixes from the fortran modules.
                     (I think the system of having author-coded filename
                     prefixes is clumsy.)

And the file "libfitsio.a" should appear upon running 'make'

------------------------------
3. FITSIO

These routines are very useful. I would encourage users to investigate
the documentation in the Pe_FITSIO directory.

Two files which appear here (ftinit2.f and fopnx2.f) are my own
subversions of the FITSIO routines which allow for "rude" opening
of FITS files, writing over existing files without errors or
warnings.


-Guy Worthey
 20 Jan 1996
