Go to file
Manolo Gouy bb9dd96ad3 Fixed Mac OS crash when using Fl_Native_File_Chooser with filter that does not end with \n.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9029 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-09-04 13:50:31 +00:00
cairo Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
CMake Updated CMake files with patches from Michael Surette (STR #2317). 2010-11-30 10:34:43 +00:00
documentation Backing out r9025; the correct info is at the top of the document 2011-09-02 21:01:28 +00:00
examples Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
FL Added missing declaration of the fl_find() function. 2011-09-02 14:42:02 +00:00
fluid Fluid -c would destroy the file history every time it was run. 2011-08-18 13:43:39 +00:00
GL Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
ide Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
jpeg Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
lib Use true instead of : for POSTBUILD on non-MacOS systems. 2002-06-24 19:49:45 +00:00
misc Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
png Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
src Fixed Mac OS crash when using Fl_Native_File_Chooser with filter that does not end with \n. 2011-09-04 13:50:31 +00:00
test Added missing svn properties to test/rotated_text.cxx 2011-08-05 08:43:26 +00:00
zlib Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
ANNOUNCEMENT First checkin simply updating a few version numbers and copyright dates 2008-03-27 21:38:44 +00:00
CHANGES Fixed fl_pie() drawing too small on X11 (STR #2703) 2011-08-30 07:50:16 +00:00
CMakeLists.txt Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
configh.cmake.in Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
configh.in Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
configure.in Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
COPYING Finished up changes for references to fltk-bugs@fltk.org -> STR form. 2010-04-28 07:21:41 +00:00
CREDITS Common dialogs like fl_message() and fl_ask() can now have a window 2011-02-12 12:08:52 +00:00
DartConfig.cmake Cmake updates (STR #645) 2005-02-06 00:17:50 +00:00
fltk-config.cmake.in Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
fltk-config.in Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
fltk.list.in Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
fltk.spec.in Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
fltk.xpm Add FLTK logo file for distributions. 2003-06-13 17:35:17 +00:00
forms.h Initial revision 1998-10-06 18:21:25 +00:00
install-sh Make sure INSTALL command uses absolute path for install-sh... 2007-02-08 19:14:29 +00:00
mac_endianness.h Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
Makefile Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
makeinclude.in Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
makesrcdist Modified documentation/Makefile to correctly generate docs. 2011-01-05 12:55:10 +00:00
README Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
README.Cairo.txt Fix STR #2504 (first part). Replaced HAVE _CAIRO by FLTK_HAVE_CAIRO and USE_CAIRO 2011-01-06 10:24:58 +00:00
README.CMake.txt Merged the CMake documenation and adapted the format to the one used in the other README fiels (mainly adding a TOC). 2010-12-20 20:00:44 +00:00
README.MSWindows.txt Removed obsolete link from README.MSWindows.txt 2010-12-22 14:32:11 +00:00
README.OSX.txt Mac OS only: Added the architecture flags to the dynamic library-creating command 2011-02-24 10:27:33 +00:00
README.Unix.txt Corrected typos. 2010-12-23 09:49:57 +00:00

README - Fast Light Tool Kit (FLTK) Version 1.3.0
-------------------------------------------------

WHAT IS FLTK?

    The Fast Light Tool Kit ("FLTK", pronounced "fulltick") is a
    a cross-platform C++ GUI toolkit for UNIX(r)/Linux(r) (X11),
    Microsoft(r) Windows(r), and MacOS(r) X. FLTK provides
    modern GUI functionality without the bloat and supports 3D
    graphics via OpenGL(r) and its built-in GLUT emulation. It
    was originally developed by Mr. Bill Spitzak and is
    currently maintained by a small group of developers across
    the world with a central repository in the US.


LICENSING

    FLTK comes with complete free source code. FLTK is available
    under the terms of the GNU Library General Public License.
    Contrary to popular belief, it can be used in commercial
    software! (Even Bill Gates could use it.) 


ON-LINE DOCUMENTATION

    All of the documentation is in HTML in the subdirectory
    "documentation". The "index.html" file should be your
    starting point.  PostScript(tm) and PDF versions of this
    documentation is also available from the FLTK web site at:

        http://www.fltk.org/documentation.php


BUILDING AND INSTALLING FLTK UNDER UNIX AND Mac OS X

    In most cases you can just type "make".  This will run
    configure with the default (no) options and then compile
    everything.

    FLTK uses GNU autoconf to configure itself for your UNIX
    platform. The main things that the configure script will
    look for are the X11, OpenGL (or Mesa), and JPEG header and
    library files.  Make sure that they are in the standard
    include/library locations.  If they aren't you need to
    define the CFLAGS, CXXFLAGS, and LDFLAGS environment
    variables.

    If you aren't using "gcc", "g++", "c++", or "CC" for your
    C++ compiler, you'll also need to set the CXX environment
    variable. Similarly, if you aren't using "gcc" or "cc" for
    your C compiler you'll need to set the CC environment
    variable.

    You can run configure yourself to get the exact setup you
    need. Type "./configure <options>".  Options include:

	--enable-cygwin         - Enable the Cygwin libraries (WIN32)
	--enable-debug          - Enable debugging code & symbols
	--disable-gl            - Disable OpenGL support
	--enable-shared         - Enable generation of shared libraries
	--enable-threads        - Enable multithreading support
	--enable-xdbe           - Enable the X double-buffer extension
	--enable-xft            - Enable the Xft library (anti-aliased fonts)

	--bindir=/path          - Set the location for executables
                        	  [default = /usr/local/bin]
	--libdir=/path          - Set the location for libraries
                        	  [default = /usr/local/lib]
	--includedir=/path      - Set the location for include files.
                        	  [default = /usr/local/include]
	--prefix=/dir           - Set the directory prefix for files
                        	  [default = /usr/local]

    When the configure script is done you can just run the
    "make" command. This will build the library, FLUID tool, and
    all of the test programs.

    To install the library, become root and type "make
    install".  This will copy the "fluid" executable to
    "bindir", the header files to "includedir", and the library
    files to "libdir".
    
    To install additional files and icons to be used by the main
    desktop environments such as KDE, GNOME and XFCE, you will also
    need to run "make install-desktop" as root.


BUILDING FLTK UNDER MICROSOFT WINDOWS

    There are two ways to build FLTK under Microsoft Windows. 
    The first is to use the Visual C++ project files under the
    "ide/" directory.  See the file ide/README.IDE for more info.

    The second method is to use a GNU-based development tool.
    To build with the Cygwin or MinGW tools, use the supplied
    configure script as specified in the UNIX section above:

        sh configure ...options...


INTERNET RESOURCES

    FLTK is available on the 'net in a bunch of locations:

	- WWW:   http://www.fltk.org/
	         http://www.fltk.org/str.php [for reporting bugs]
	         http://www.fltk.org/software.php [source code]

	- FTP:   http://ftp.easysw.com/pub/fltk
	         ftp://ftp.easysw.com/pub/fltk
	         ftp://ftp2.easysw.com/pub/fltk
	         ftp://ftp.funet.fi/pub/mirrors/ftp.easysw.com/pub/fltk
	         ftp://linux.mathematik.tu-darmstadt.de/pub/linux/mirrors/misc/fltk
	         ftp://gd.tuwien.ac.at/hci/fltk

	- EMail: fltk@fltk.org [see instructions below]

    To send a message to the FLTK mailing list ("fltk@fltk.org")
    you must first join the list.  Non-member submissions are
    blocked to avoid problems with SPAM.

    To join the FLTK mailing list, go the following web page:

        http://lists.easysw.com/listinfo/fltk


REPORTING BUGS

    To report a bug in FLTK, use the form at:

        http://www.fltk.org/str.php

    For general support and questions, please use the FLTK
    mailing list at "fltk@fltk.org".


TRADEMARKS

    Microsoft and Windows are registered trademarks of Microsoft
    Corporation. UNIX is a registered trademark of the X/Open
    Group, Inc.  OpenGL is a registered trademark of Silicon
    Graphics, Inc.  Mac OS is a registered trademark of Apple
    Computers, Inc.


COPYRIGHT

    FLTK is copyright 1998-2011 by Bill Spitzak
    (spitzak@users.sourceforge.net) and others, 
    see the CREDITS file for more info.

    This library is free software. Distribution and use rights are
    outlined in the file "COPYING" which should have been included with
    this file.  If this file is missing or damaged, see the license at:

        http://www.fltk.org/COPYING.php