README for RLPlot, Copyright (c) 2002, 2003 R.Lackner

    This file is part of RLPlot.

    RLPlot is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    RLPlot is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with RLPlot; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


------------------------------------------------------------------------------
1. Building RLPlot for Linux
Before building RLPlot for Linux using the supplied 'Makefile' you probably
need to make some adaptations. RLPlot uses Trolltech's Qt and the default
Makefile assumes Qt beeing installed in /usr/local/qt.
Which version of Qt should be used ? The best version is usually that coming
with your distribution CDs. If there are several versions installed on your
machine you may experience crashes especially if you try to copy/paste data
from one application to another.
Most problems during compilation of RLPlot are due to missing Qt or installation
of Qt in a different folder. 
On most systems where Qt has been installed from the distribution
CDs the environment variable 'QTDIR' is defined. In this case you may succeed
by issuing the following command within the RLPlot folder:

      make -e

If that does not work you have to ...

1.1: Find your Qt directory.
   This is the directory where Qt has been installed. It contains the files
   ./bin/moc, ./include/qapplication.h ./lib/libqt.so (However, RLPlot needs
   more than those). If you don't find this directory you must install Qt devel.
   first from your distribution CDs or directly from www.trolltech.com.

1.2: Modify Makefile. Find the line (close to the top) where QTDIR is defined
   and fill in the path to the Qt folder.
   Possible examples include:
      QTDIR = /usr/lib/qt3
      QTDIR = /usr/lib/qt-2.3.1
	  QTDIR = /usr/local/qt-2.3.1
	  QTDIR = /usr/local/qt-x11-free-3.0.4

	Alternatively you may leave the Makefile unchanged and put a symbolic link
	into /usr/local (if /usr/local/qt does not yet exist), for example:
		cd /usr/local
		ln -s /usr/lib/qt-2.3.1 qt
	The latter method has the advantage that you can have concurrent versions
	of Qt installed on your system and need not modify Makefile everytime you
	download a new version of RLPlot. You may need root privileges to create
	the link in /usr/local

1.3: Create the RLPlot executable by execting 'make' in the RLplot folder.
   You can remove some intermediary file exceting 'make clean'.
   No further installation required. Just execute RLPlot.	   

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Problems and Platform notes:
Some recent versions of Qt use Open GL which requires additional libraries
to be included in the Makefile.

Common errors during build:

undefined reference to ...
   This error usually occurs if a library necessary for link is not specified
   in the Makefile. You have to find a suitable library and specify it in the
   LIBS definition (some examples see below). May be you do not need this library
   and the build is done properly without e.g. '-lGL'.
   Example: undefined reference to 'glXQueryServerString'
      libGL.so not specified in LIBS. Add '-lGL' to LIBS or a fully qualified
	  path to the folder with libGL.so, e.g. -L/usr/X11R6/lib 

cannot find ....
   This error occurs if a file is not found, possibly one of the libraries in
   of the LIBS definition. Probably you do not need this library and you can
   remove it from the LIBS. If this does not help you may be lucky to find it
   elsewhere (not very promising) or some package needs to be installed.
   Example: cannot find -lGL
      libGL.so specified in LIBS but not found in a standard directory
   Example: cannot find -lqt-mt
      libqt-mt.so not found. Modify the Makefile from 'QTLIBS= -lqt-mt' to
      'QTLIBS= -lqt'. If this does not help Qt is not properly installed.

There are some LIBS definitions which might work on your system
   LIBS = -L$(QTDIR)/lib -L/usr/X11R6/lib
   LIBS = -lGL -L$(QTDIR)/lib -L/usr/X11R6/lib
   LIBS = -L/usr/lib -L$(QTDIR)/lib -L/usr/X11R6/lib

------------------------------------------------------------------------------
2. Building RLPlot for Windows
To compile RLPlot from the sources you need to install
MS Visual Studio first. Once you have RLPlot.exe no further installation
is required. RLPlot does not change the registry. Double click on
the icon in the explorer window to start the program.

2.1 Building RLPlot.exe using NMAKE
   Open a DOS or command line window and move to the MSVC folder. Execute
   VCVARS32.BAT in the bin subdirectory. Change directory to the RLPlot
   folder. Whenever you close the DOS-box you need to execute VCVARS32.BAT
   again. Now execute nmake to compile and build RLPlot:
        nmake -f "Makefile.win"
   After building RLPlot you may wish to remove temporary files:
        nmake -f "Makefile.win" clean

2.2 Creating a project in the IDE
   Create a new project (RLPLot) using the MS Developer Studio creating a
   Win32 Application. Add the following files to the project: Export.cpp,
   FileIO.cpp, Output.cpp, PropertyDlg.cpp, rlplot.cpp, rlplot.h, RLPLOT.RC,
   spreadwi.cpp, TheDialog.cpp, TheDialog.h, UtilObj.cpp, Utils.cpp,
   Version.h, WinSpec.cpp, WinSpec.h. Now execute [!].

------------------------------------------------------------------------------

Success!

reinhard.lackner@uibk.ac.at

Reinhard Lackner                               Reinhard Lackner
Ing. Etzelstr. 19                              Inst. f. Zoologie u. Limnologie
A-6020 Innsbruck                               Technikerstr. 25
AUSTRIA                                        A-6020 Innsbruck
                                               AUSTRIA
