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.
2. Type "make", or (Linux and gcc only) type "make shared" to make
   a shared library.
3. Test the demo programs by running "test/demo".  If you built shared
   libraries you need to do "setenv LD_LIBRARY_PATH $PWD/lib" first.

To install the new version of Fltk and fluid:

1. Type "su" and then your password
2. Remove the file /usr/local/lib/libFl.a if it exists (this is an
   old version and removing it will prevent accidentally linking it)
3. Type "make install"
4. Type ^D to get out of su.

This will install the library, include files, and fluid in
/usr/local/{lib,include,bin}.  If you built shared libraries you will
need to run ldconfig (I need instructions here).

Fltk has been compiled and tested on:

  SGI IRIX 5.3, 6.2, 6.3 on many SGI platforms
  Linux 2.0.18 and higher
  Linux 2.1.42 on Dec Alpha
  Solaris with both gcc and sun's C++ (OpenGL not tested)
  WindozeNT on both Intel and Alpha (see win32/README for instructions)

I have heard it works on Windoze95, AIX, HPUX, SunOS, Lynx, and
FreeBSD.  It should work on any Unix+X system with a C++ compiler.  If
you succeed in getting Fltk to compile on a new system, PLEASE tell me
(even if you did not have to change anything).  Of course, if you had
to alter a file, I am even more interested in hearing about it!

Shared libraries only work with gcc and have only been tested on
Linux.  Any help here would be appreciated.

----------------------------------------------------------------
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
----------------------------------------------------------------
