This is the file holding the instructions to compile and install
Mplot++, a math plotter for Unix(R)/Windows(R)/MacOS X(R) - version 0.78    
  Copyright (C)  2002    Ivano Primi ( ivano.primi@tin.it )    

This program 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.

This program 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 this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

You can contact the author of this software by paper mail writing to
the next address

	Ivano Primi
	via Colle Cannetacce 50/A
	C.A.P. 00038 - Valmontone (ROMA)
	Italy                                                      .

If you prefer the electronic mail you can write to the address

	ivano.primi@tin.it                                         .

*****************************************************************************

If you want to install Mplot++ on your system you must have already
installed the Fast Light Tool Kit (version 1.0.x or 1.1.x), also named
FLTK. Moreover,you must make sure that on the system where you are going
to install the program there are:
1 - The `bash' shell (or another shell sh-compatible);
2 - The `make' utility;
3 - The X-Window System and the related library libX11.so (or/and libX11.a);
4 - The mathematic library libm.so ( or/and libm.a);
Of course, whatever you need to compile an ANSI-C++ program must be already
present on the system.
FLTK is a C++ Graphical User Interface Toolkit for Unix(R), MacOS X(R)
and Microsoft Windows(R).
Now FLTK has started being included on Linux(R) distributions.
FLTK (= Fast Light Tool Kit) comes with complete free source code and is
available under the terms of the GNU Library General Public License. 
If on your system FLTK has not been installed yet, you need to know that 
FLTK is available on the 'net in a bunch of locations:

WWW

	http://www.fltk.org

FTP
	
	California,USA (ftp.fltk.org)
	Maryland,USA   (ftp2.fltk.org)
	Espoo,Finland  (ftp.funet.fi)
	Germany (linux.mathematik.tu-darmstadt.de)
	Austria (gd.tuwien.ac.at)

Perhaps you are worried about the time you will need to compile and
install FLTK and about the space the library will occupy on your hard-disk.
Do not worry about this! The compilation time of FLTK is very short and
the compiled library will occupy less than 500 Kb even if it is very
powerfull !

If you have installed FLTK in a standard location (like '/usr/local/lib'
or '/usr/lib' for the library and '/usr/local/include' or '/usr/include'
for the header files) you may simply try with these commands:

	./configure
	make
	make install

Of course, these commands must be given to a shell into a terminal.
Moreover, if you want to install the program inside a system-directory
you have to launch the 'make install' command as root.
If you are a programmer and you want to contribute to the debug of Mplot++
maybe you are interested in producing debugging informations for the
code you are about to compile; you can do this by using

        ./configure --enable-debug
	
in place of the simple

        ./configure
	
command. If you want to produce optimized code and g++ (gcc) is your compiler 
then you have to define the environment-variable CPPFLAGS as "-O" or "-O2"
before to launch the

        ./configure
	
script. Be careful !  With g++ you can enable debug and optimization
at the same time if you wish so.
If you have not installed FLTK in a standard location then:
1) you must add to the LD_LIBRARY_PATH environment-variable the path
   where you have found libfltk.a or libfltk.so;
2) you must define the environment-variable CPPFLAGS as "-Iincludepath"
   ( or "-Iincludepath -O2" if you want to produce optimized code too ),
   where 'includepath' is the path of the FLTK header files;
3) you must set the environment-variable LDFLAGS to "-Llibrarypath",
   where 'librarypath' is the path of the file libfltk.a or libfltk.so .
After this (and only after this), you can launch the configure script
and the other commands necessary to build the program.
Be careful! If the header files of FLTK are inside the directory /.../xx...x/FL
you have to set 'includepath' to "/.../xx...x", i.e. you must omit the final
/FL of the path.
By default, the installation procedure places the binary file of Mplot++
(named mplotxx) and the files of the online help in 2 subdirectory of
'/usr/local': the binary file is installed into '/usr/local/bin', the files
of the help and the docs into '/usr/local/share/mplotxx'; if these
subdirectories do not exist it tries to create them. Of course, you can
change these default paths trough the options passed to the configuration
script. For example, if you want to install the executable file inside
'/usr/bin' and the help-files into the subdir '/usr/share/mplotxx' you can
obtain this by calling './configure' in this way:

	./configure --prefix=/usr

or in this other way

	./configure --bindir=/usr/bin --datadir=/usr/share/mplotxx .

Be Careful ! If you use the option --prefix=PREFIX the executable will be
installed into 'PREFIX/bin' and the help-files into 'PREFIX/share/mplotxx'
(instead of 'PREFIX/share').
After the installation, give the command 'make clean' to remove
the object-files from the source directory of the program.
Remember !  If you have built Mplot++ with a dinamic version of the
FLTK library the corresponding path must be found between those of the
LD_LIBRARY_PATH global variable or must be found inside the file
/etc/ld.so.conf (on Linux-systems). If this is not the case, the program
will not work.

Sorry, i do not supply the Makefile for Microsoft Windows(R) or MacOS X(R),
I work only on Linux(R) and SunOS(R).
Perhaps, the instructions before are good for MacOS X too, but i do not
know, really !

Enjoy !!!

