Go to file
Albrecht Schlosser f34719851e Fl_File_Chooser: set insert position to end of string (#1004)
... after filename "expansion" with current directory.

Backported from 1.4: commit ecb3c9c6fc.
Code modified to work with 1.3.x.

Updated CHANGES.
2024-07-04 16:29:59 +02:00
cairo Fix several compiler warnings 2023-12-04 17:40:31 +01:00
CMake Raise CMake minimum required version to 3.15 and more 2023-12-09 14:58:40 +01:00
documentation Bump version numbers from 1.3.9 to 1.3.10 2024-05-14 15:57:04 +02:00
examples Backport CMake and related stuff from 1.4 (master) 2021-04-08 14:57:40 +02:00
FL Bump version numbers from 1.3.9 to 1.3.10 2024-05-14 15:57:04 +02:00
fluid Bump version numbers from 1.3.9 to 1.3.10 2024-05-14 15:57:04 +02:00
GL Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
html Fix (remove) executable file attributes. 2016-11-10 00:50:18 +00:00
ide Bump version numbers from 1.3.9 to 1.3.10 2024-05-14 15:57:04 +02:00
jpeg Update bundled libraries 2024-05-14 15:57:39 +02:00
lib Rename lib/README.lib to lib/README because '*.lib' is in ignored files list. 2015-02-26 12:57:18 +00:00
misc Backport CMake and related stuff from 1.4 (master) 2021-04-08 14:57:40 +02:00
png Update bundled libraries 2024-05-14 15:57:39 +02:00
src Fl_File_Chooser: set insert position to end of string (#1004) 2024-07-04 16:29:59 +02:00
test macOS: let fullscreen windows have access to the system menubar 2024-05-22 10:37:18 +02:00
zlib Update bundled libraries 2024-05-14 15:57:39 +02:00
.gitattributes Prepare release candidate 2 (1.3.5rc2) 2019-02-17 12:53:19 +01:00
.gitignore Refactor macOS bundle generation to avoid "quarantine" 2021-05-03 16:11:05 +02:00
.travis.yml Prepare release candidate 2 (1.3.5rc2) 2019-02-17 12:53:19 +01:00
abi-version.cmake.in Remove copyright markers from abi-version.* (STR #3161). 2016-07-29 18:50:07 +00:00
abi-version.ide Remove copyright markers from abi-version.* (STR #3161). 2016-07-29 18:50:07 +00:00
abi-version.in Remove copyright markers from abi-version.* (STR #3161). 2016-07-29 18:50:07 +00:00
ANNOUNCEMENT Bump version numbers from 1.3.9 to 1.3.10 2024-05-14 15:57:04 +02:00
autogen.sh Add an autogen.sh script as is customary for autoconf based 2013-12-13 10:19:54 +00:00
CHANGES Fl_File_Chooser: set insert position to end of string (#1004) 2024-07-04 16:29:59 +02:00
CHANGES_1.0 Split CHANGES file(s). Part 1: add CHANGES_1.0 and CHANGES_1.1. 2014-10-27 17:12:03 +00:00
CHANGES_1.1 Split CHANGES file(s). Part 1: add CHANGES_1.0 and CHANGES_1.1. 2014-10-27 17:12:03 +00:00
CMakeLists.txt Bump version numbers from 1.3.9 to 1.3.10 2024-05-14 15:57:04 +02:00
configh.cmake.in Backport CMake and related stuff from 1.4 (master) 2021-04-08 14:57:40 +02:00
configh.in Fix compiler warnings (STR #2988). 2016-01-31 02:49:56 +00:00
configure.ac Bump version numbers from 1.3.9 to 1.3.10 2024-05-14 15:57:04 +02:00
COPYING Finished up changes for references to fltk-bugs@fltk.org -> STR form. 2010-04-28 07:21:41 +00:00
CREDITS Finalize release 1.3.7 2021-07-25 15:16:28 +02:00
DartConfig.cmake Backport CMake and related stuff from 1.4 (master) 2021-04-08 14:57:40 +02:00
fltk_version.dat Bump version numbers from 1.3.9 to 1.3.10 2024-05-14 15:57:04 +02:00
fltk-config.in Fix FLTK_VERSION_XXX strings in configure et al 2021-04-09 14:08:03 +02:00
fltk.list.in Update CHANGES, README, README.CMake.txt, support files 2023-12-05 18:37:56 +01:00
fltk.spec.in Update CHANGES, README, README.CMake.txt, support files 2023-12-05 18:37:56 +01:00
fltk.xpm
forms.h
install-sh
KNOWN_BUGS.html Finalize release 1.3.7 2021-07-25 15:16:28 +02:00
mac_endianness.h Modifications to all LGPL headers for STR #2685. 2011-07-19 04:49:30 +00:00
Makefile Backport CMake and related stuff from 1.4 (master) 2021-04-08 14:57:40 +02:00
makeinclude.in Fix version number in doxygen docs 2021-04-28 12:41:40 +02:00
makesrcdist Update CHANGES, README, README.CMake.txt, support files 2023-12-05 18:37:56 +01:00
README Bump version numbers from 1.3.9 to 1.3.10 2024-05-14 15:57:04 +02:00
README.abi-version.txt Improve ABI configuration documentation 2019-01-19 17:16:09 +01:00
README.bundled-libs.txt Update bundled libraries 2024-05-14 15:57:39 +02:00
README.Cairo.txt Typos and formatting, again. 2011-12-10 15:35:00 +00:00
README.CMake.txt Raise CMake minimum required version to 3.15 and more 2023-12-09 14:58:40 +01:00
README.MSWindows.txt Update README's and some documentation 2019-02-09 16:44:37 +01:00
README.OSX.txt Update README's and some documentation 2019-02-09 16:44:37 +01:00
README.Unix.txt Update README's and some documentation 2019-02-09 16:44:37 +01:00

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

WHAT IS FLTK?

    The Fast Light Tool Kit ("FLTK") is a cross-platform C++ GUI
    toolkit for UNIX(r)/Linux(r) (X11), Microsoft(r) Windows(r),
    and macOS(r). FLTK provides modern GUI functionality without
    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 on GitHub.

        https://www.fltk.org/
        https://github.com/fltk/fltk/


LICENSING

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


ON-LINE DOCUMENTATION

    The documentation in HTML and PDF forms can be created by
    Doxygen from the source files. HTML and PDF versions of this
    documentation is also available from the FLTK web site at:

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


BUILDING AND INSTALLING FLTK UNDER UNIX AND macOS

    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]

    For more options please see './configure --help'.

    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.


GIT USERS

    If you've just checked out a fresh copy of FLTK from Git (GitHub),
    you'll need to generate an initial version of 'configure'
    by running 'make makeinclude' or 'make clean' (we don't
    include a copy of configure in git).


MAKE TARGETS

    make            -- builds the library + test programs (does not install)
    make install    -- builds and installs
    make clean      -- clean for a rebuild
    make distclean  -- like 'clean', but also removes docs, configure, fltk-config
    ( cd src; make ) -- builds just the fltk libraries


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


BUILDING HTML DOCUMENTATION

    If you want to build the HTML documentation:

    	( cd documentation && make html )

    If you want to build the PDF documentation:

    	( cd documentation && make pdf )

    FLTK uses doxygen for documentation, so you'll at least need doxygen
    installed for creating html docs, and LaTeX for creating PDF docs.


INTERNET RESOURCES

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

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


GENERAL QUESTIONS

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

        https://groups.google.com/forum/#!forum/fltkgeneral

    You can find detailed instructions how you can register for the mailing
    list (even w/o a Google mail address) at the bottom of this page:

        https://www.fltk.org/newsgroups.php


REPORTING BUGS

    If you are new to FLTK, or have general questions about how to use FLTK,
    or aren't sure if you found a bug, please ask first on the fltk.general
    group forum at:

        https://groups.google.com/forum/#!forum/fltkgeneral

    See paragraph GENERAL QUESTIONS above for more info.

    If you are sure you found a bug, please see the following page for
    further information:

        https://www.fltk.org/bugs.php


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.  macOS is a registered trademark of Apple
    Computers, Inc.


COPYRIGHT

    FLTK is copyright 1998-2024 by Bill Spitzak 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:

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