
           This is the standalone distribution of fv3.0.

With fv3.0 we are distributing unix versions in both source and binary
form.  Binaries are available for Sun Solaris, Dec OSF, and PC Linux
(kernel 2.2).  For the binaries, merely download the appropriate tar
file, decompress it, and run the fv executable located in the expanded
fv3.0 directory.


To build fv from the source distribution (note that SunOS 4 is no
longer supported), do the following:


1. Building fv requires an ANSI C compiler (eg, gcc).  If your default
   cc compiler is not ANSI (eg, the old SunOS compiler) but have gcc
   installed, before building fv, type

      > setenv CC gcc

   If you do not have an ANSI C compiler, you can obtain gcc from any
   of the gnu ftp sites listed at http://www.gnu.org/order/ftp.html.

2. To build fv, type 'make FV=$PWD/[Machine]', where [Machine]
   is something that identifies which type of computer you're
   building this on (you get to chose this name, the build
   doesn't care what name you pick).  For this example, we'll use
   'IRIX'.  So, you type:

      > make FV=$PWD/IRIX

3. If all goes well, type

      > make FV=$PWD/IRIX install

   [optional]
   You can clean up all of the intermediate parts of the build by typing
   'make distclean' in the fv/ directory.

   [very optional]
   If you're really strapped for space you can remove all of
   the directories under fv/ *except* the "IRIX" one (or
   whatever you called it) when you are through with the build.

4. To run fv, set an environment variable FV to the path to your install 
   directory and then add $FV/bin to your path.  For example, my .login
   contains:

      setenv FV /redshift/sgi6/elwin/fv/IRIX
      set path = ($FV/bin $path)

   Six sample FITS files are included in the fv/sample_data directory.
   Enter the directory and type, for example, 'fv rate.fits'.

5. Report any problems to:

      ftoolshelp@athena.gsfc.nasa.gov

6. Visit the fv website for information on bugs and future releases:

      http://heasarc.gsfc.nasa.gov/ftools/fv


Known problems -

   fv will not work on Ultrix (no shared libraries), AIX systems, or
   SunOS 4 systems.


Note for advanced installations - 

   The final installed location of fv can be anywhere you want,
   really; you could even use 'make FV=/usr/local' but that is
   probably a very bad idea.  You can also build several
   architectures out of the same source tree.  E.g. to build fv
   for Solaris and Dec Unix, you could, after untarring fv do
   (on your Solaris machine):

      >make FV=$PWD/SOLARIS
      >make FV=$PWD/SOLARIS install

   then on your Dec machine:

      >make distclean
      >make FV=$PWD/DU4
      >make FV=$PWD/DU4 install

   and then

      >make distclean

   again if you want.

