[Kst] Installation instructions

[rchern]

Could/should the attached installation instructions (taken from the Kst Handbook) be included as a text file in the 0.98 release?

Rick. 
-------------- next part --------------
   <kst at kde.org>

   0.98

   Copyright (c) 2004 The University of British Columbia

   Permission is granted to copy, distribute and/or modify this document
   under the terms of the GNU Free Documentation License, Version 1.1 or any
   later version published by the Free Software Foundation; with no Invariant
   Sections, with no Front-Cover Texts, and with no Back-Cover Texts. 

   The following sections contain detailed instructions for obtaining,
   compiling, and installing KST along with any optional libraries or
   packages. If you use a package management system, you may use it to
   install KST instead.

Installing KST from Source

   The following sections detail how to compile and install KST from source
   code.

  Requirements

   KST v0.97 requires KDE 3.1 and Qt(TM) 3.1. Almost all major Linux(R)
   distributions have packages for KDE and Qt(TM). Since Qt(TM) is a
   dependency of KDE, having the required version of KDE should be
   sufficient. It is recommended that you refer to your particular
   distribution's documentation for KDE installation. Alternatively, more
   information is available on the KDE website.

  Optional Libraries and Packages

   The following libraries and packages are required for full plugin and
   logging functionality in KST. The installation instructions assume you
   have root access on your system.

    GNU Scientific Library (GSL)

   The GNU Scientific Library provides a variety of mathematical operations
   for the built-in KST plugins. The library can be found at
   ftp://ftp.gnu.org/gnu/gsl/. Alternatively, you can find GSL under /gnu/gsl
   on the mirrors listed at http://www.gnu.org/prep/ftp.html.

   Download gsl-[ver].tar.gz, where [ver] is the greatest version number
   found in the directory.

   Then unzip and untar the file:

 tar -zxvf gsl-[ver].tar.gz

   replacing [ver] with the version number of the downloaded file.

   Read the INSTALL file in the resultant directory for detailed installation
   instructions. For most systems, the following will work:

 cd gsl-[ver]
 ./configure
 make
 make install

    CFITSIO

   The CFITSIO library provides support for reading and writing to the FITS
   (Flexible Image Transport System) data format. The library can be found at
   ftp://heasarc.gsfc.nasa.gov/software/fitsio/c/.

   Download cfitsio[ver].tar.gz, where [ver] is the greatest version number
   found the directory.

   Then unzip and untar the file:

 tar -zxvf cfitsio[ver].tar.gz

   replacing [ver] with the version number of the downloaded file.

   Read the README file in the resultant directory for installation
   instructions. For most systems, the following will work:

 cd cfitsio
 ./configure --prefix=/usr
 make
 make install

   You may need to change the directory specified for the --prefix option,
   but the most common directory is /usr

  Compiling and Installing

   Once all of the prerequisites have been met on your system you can compile
   and install KST. It is assumed that you have already downloaded the KST
   source package. If not, please see Obtaining KST.

   The simplest way to install KST is:

 tar -zxvf kst-[ver].tar.gz
 cd kst-[ver]
 ./configure --enable-final --prefix=`kde-config --prefix`
 make
 make install

   replacing [ver] with the version of KST you have.

  Important

   Note that kde-config --prefix is surrounded by backquotes. It is very
   important that the kde-config utility returns the correct path (most
   likely /usr), otherwise KST will not install properly. You can
   double-check by running it directly:

 kde-config --prefix

   Ensure that a non-null path is displayed.

   You can read through the messages displayed by the configure script--if it
   reports any missing libraries (such as GSL) that should not be missing,
   please go back and ensure that the libraries and header files have been
   correctly installed in the appropriate locations.