Doco and header updates for 1.0.10.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.0@1332 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 96 insertions, 85 deletions

diff --git a/README b/README
index 34e5b7303..a554d01ef 100644
--- a/README
+++ b/README
@@ -1,53 +1,56 @@
-README - Fast Light Tool Kit (FLTK) Version 1.0.9
--------------------------------------------------
+README - Fast Light Tool Kit (FLTK) Version 1.0.10
+--------------------------------------------------
 
 WHAT IS FLTK?
 
-    The Fast Light Tool Kit ("FLTK", pronounced "fulltick") is a LGPL'd
-    C++ graphical user interface toolkit for X (UNIX(r)), OpenGL(r),
-    and Microsoft(r) Windows(r) NT 4.0, 95, or 98. 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.
+    The Fast Light Tool Kit ("FLTK", pronounced "fulltick") is a
+    LGPL'd C++ graphical user interface toolkit for X (UNIX(r)),
+    OpenGL(r), and Microsoft(r) Windows(r) NT 4.0, 95, or 98. 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.) 
+    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:
+    "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://fltk.easysw.com/documentation.html
 
 
 BUILDING AND INSTALLING FLTK UNDER UNIX
 
-    In most cases you can just type "make".  This will run configure
-    with the default (no) options and then compile everything.
+    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.
+    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.
+    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:
+    You can run configure yourself to get the exact setup you
+    need. Type "./configure <options>".  Options include:
 
 	--enable-debug          - Enable debugging code & symbols
 	--enable-shared         - Enable generation of shared libraries
@@ -61,26 +64,27 @@ BUILDING AND INSTALLING FLTK UNDER UNIX
 	--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.
+    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 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".
 
 
 BUILDING FLTK UNDER MICROSOFT WINDOWS
 
-    There are two ways to build FLTK under Microsoft Windows.  The
-    first is to use the 5.0 project files under the "visualc"
-    directory.  Just open (or double-click on) the "fltk.dsw" file to
-    get the whole shebang.
+    There are two ways to build FLTK under Microsoft Windows. 
+    The first is to use the 5.0 project files under the
+    "visualc" directory.  Just open (or double-click on) the
+    "fltk.dsw" file to get the whole shebang.
 
-    The second method is to use a GNU-based development tool with the
-    files in the "makefiles" directory.  To build using one of these
-    tools simply copy the appropriate makeinclude and config files to
-    the main directory and do a make:
+    The second method is to use a GNU-based development tool
+    with the files in the "makefiles" directory.  To build using
+    one of these tools simply copy the appropriate makeinclude
+    and config files to the main directory and do a make:
 
 	copy makefiles\Makefile.<env> Makefile
 	make
@@ -88,12 +92,13 @@ BUILDING FLTK UNDER MICROSOFT WINDOWS
 
 BUILDING FLTK UNDER OS/2
 
-    The current OS/2 build requires XFree86 for OS/2 to work.  A native
-    Presentation Manager version has not been implemented yet
-    (volunteers are welcome!).
+    The current OS/2 build requires XFree86 for OS/2 to work.  A
+    native Presentation Manager version has not been implemented
+    yet (volunteers are welcome!).
 
-    To build the XFree86 version of FLTK for OS/2, copy the appropriate
-    makeinclude and config files to the main directory and do a make:
+    To build the XFree86 version of FLTK for OS/2, copy the
+    appropriate makeinclude and config files to the main
+    directory and do a make:
 
         copy makefiles\Makefile.os2x Makefile
 	make
@@ -104,6 +109,7 @@ INTERNET RESOURCES
     FLTK is available on the 'net in a bunch of locations:
 
 	- WWW:   http://www.fltk.org
+	         http://fltk.sourceforge.net
 
 	- FTP:   ftp://ftp.easysw.com/pub/fltk
                  ftp://ftp2.easysw.com/pub/fltk
@@ -113,51 +119,54 @@ INTERNET RESOURCES
 	- EMail: fltk@fltk.org [see instructions below]
         	 fltk-bugs@fltk.org [for reporting bugs]
 
-    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 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, send a message to
-    "majordomo@fltk.org" with "subscribe fltk" in the message body. 
-    A digest of this list is available by subscribing to the
-    "fltk-digest" mailing list.
+    "majordomo@fltk.org" with "subscribe fltk" in the message
+    body.  A digest of this list is available by subscribing to
+    the "fltk-digest" mailing list.
 
 
 REPORTING BUGS
 
-    To report a bug in FLTK, send an email to "fltk-bugs@fltk.org".
-    Please include the FLTK version, operating system & version, and
-    compiler that you are using when describing the bug or problem.
+    To report a bug in FLTK, send an email to
+    "fltk-bugs@fltk.org". Please include the FLTK version,
+    operating system & version, and compiler that you are using
+    when describing the bug or problem.
 
-    For general support and questions, please use the FLTK mailing
-    list at "fltk@fltk.org".
+    For general support and questions, please use the FLTK
+    mailing list at "fltk@fltk.org".
 
 
 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).
+    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 available at:
 
-    Mesa is available at "http://www.ssec.wisc.edu/~brianp/Mesa.html".
+        http://www.mesa3d.org
 
-    The configure script will not see Mesa unless it is installed as
-    either libGL or libMesaGL.  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).
+    The configure script will not see Mesa unless it is
+    installed as either libGL or libMesaGL.  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).
 
 
 TRADEMARKS
 
     Microsoft and Windows are registered trademarks of Microsoft
-    Corportation. UNIX is a registered trademark of the X/Open Group,
-    Inc.  OpenGL is a registered trademark of Silicon Graphics, Inc.
+    Corportation. UNIX is a registered trademark of the X/Open
+    Group, Inc.  OpenGL is a registered trademark of Silicon
+    Graphics, Inc.
 
 
 COPYRIGHT
 
-    FLTK is copyright 1998-2000 by Bill Spitzak (spitzak@d2.com) and others,
-    including:
+    FLTK is copyright 1998-2000 by Bill Spitzak (spitzak@d2.com)
+    and others, including:
 
         Craig P. Earls (cpearls@mit.edu)
 	Curtis Edwards (curtise@fa.disney.com)
@@ -167,17 +176,19 @@ COPYRIGHT
         Michael Sweet (mike@easysw.com)
 	Carl Thompson (cet@elinix.net)
 
-    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.
+    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.