INSTALLATION OF STARPLOT

1. Prerequisites

You will need to have version 2 of the GTK+ library, including the pkg-config
tool and the development headers (gtk.h, gdk.h, etc.), installed on your
system.  Many Linux distributions will include these by default.  On RedHat,
you will need to have the gtk2-devel RPM installed.  On Debian, have the
libgtk2.0-dev package installed.  On Mac OS X, have the Fink packages
gtk+2-dev and atk1 installed.  For other Linux distributions and Unices,
refer to your system documentation.

2. Normal installation

For generic configure instructions, see the file INSTALL.generic in this
directory.  In general, for a normal installation of StarPlot you should need
to type only this:

	./configure && make && sudo make install

Of course, you must have permissions to run "make install" as root.  If not,
use configure's "--prefix <dir>" flag to install StarPlot to a directory within
your home directory.

Debian packages may be obtained from http://packages.debian.org/starplot
(or simply "apt-get install starplot").  If the package is out of date, just
wait a few days for it to be updated.  These packages are courtesy of
Francisco García <franciscomanuel.garcia@hispalinux.es>.

RPMs of StarPlot are unfortunately not available since I don't have any
RPM-based Linux distributions lying around.  If anyone wants to submit a
working RPM spec file, please do.

3. StarPlot-specific options to the configure script

--with-webbrowser=PROGRAM

Always use PROGRAM to view StarPlot help files.  This removes the menu option
"Help->Select Help Browser".  Of course, PROGRAM should be a web browser or
something else that can understand and display URIs of the forms file:// and
http://.

4. Installing StarPlot data files

This cannot be done until you have installed StarPlot itself.  The man page for
the "starpkg" script should tell you everything you need to know.  To make your
own StarPlot data files, see the man page for "starconvert".

