Fast Light Tool Kit (fltk) Version 0.99

----------------------------------------------------------------
How to build and install fltk:
----------------------------------------------------------------

See the file win32/README for information for Windoze95/NT.

1. Type "./configure", and then examine config.h and makeinclude.
1. Edit the file ./style.h to customize the appearance of fltk
3. Type "make", or (Linux and gcc only) type "make shared" to make
   a shared library.
4. For shared libraries, type "setenv LD_LIBRARY_PATH $PWD/lib"
5. Test it by running "test/demo".

To install the new version of Fltk and fluid (this puts the library in
/usr/local/lib, the include files in /usr/local/include/FL, and fluid
into /usr/local/bin):

1. If you made the shared version, type "unsetenv LD_LIBRARY_PATH"
2. Type "su" and then your password
3. Type "make install"
4. If you made the shared version, type "/sbin/ldconfig"
5. Type ^D to get out of su.

----------------------------------------------------------------
On-line documentation:
----------------------------------------------------------------

All the documentation is in html in the subdirectory "documentation".
Use file:<here>/documentation/index.html to get started.  Install
should put the documentation in /usr/doc/fltk but this is not yet
implemented.

These files are readable without a browser:

Change log is in documentation/CHANGES
To Do list is in documentatoin/TODO.html

----------------------------------------------------------------
WWW resources:
----------------------------------------------------------------

The Fltk home page: http://www.cinenet.net/users/spitzak/fltk

Mirror site: http://fltk.easysw.com

To post to the fltk mailing list: fltk@easysw.com

To subscribe, send "subscribe fltk" to majordomo@easysw.com

Send mail to Bill Spitzak (the author of fltk): spitzak@d2.com

Get Mesa (necessary to run OpenGl on most Linux machines):
    http://www.ssec.wisc.edu/~brianp/Mesa.html

----------------------------------------------------------------
Window managers
----------------------------------------------------------------

Fltk now uses X transient windows for modal() windows.  This may
confuse some window managers.  Mostly it causes them to not put
any borders on the modal windows and prevent you from moving them.

For FVWM I recommend you put "DecorateTransients" into your .fvwmrc.

----------------------------------------------------------------
Mesa:
----------------------------------------------------------------

Currently the best way to get OpenGL on your Linux system is to use
Mesa.  Fltk has been tested with Mesa on several machines (and also
with "real" OpenGL on SGI machines).

Mesa is at:  http://www.ssec.wisc.edu/~brianp/Mesa.html

./configure will not see Mesa unless it is installed as either libGL
or libMesa.  If you don't want to do this you will have to edit
config.h (set HAVE_GL to 1) and makeinclude (add the libraries).

----------------------------------------------------------------
How to write programs that use Fltk:
----------------------------------------------------------------

The proper way to include Fltk header files is "#include <FL/Fl_xyz.H>".
If Fltk is installed this will work without switches.  If not you will
need to provide a -I switch pointing to this directory (all the
headers are in ./FL).

Linker switches will be something like "-lfltk -L/usr/X11R6/lib -lX11".
Some programs may require -lXext or -lm.  If Fltk is not installed you
will need to add a -L switch pointing at ./lib.

If you wish to distribute a program (in source form) that uses Fltk,
you are allowed by the license to directly include the portions of
Fltk that you need.  This may make it easier for a user to compile
your program since they don't need to install the library.  Please
provide instructions for the user on how they can get the entire
source of Fltk.

If you wish to distribute a compiled program without source code: this
is allowed.  See the license.

----------------------------------------------------------------
Copyright (C) 1998 Bill Spitzak
----------------------------------------------------------------
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.

This library 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
Library General Public License for more details.

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

Written by Bill Spitzak		spitzak@d2.com
----------------------------------------------------------------