fltk/documentation
Bill Spitzak be106a0977 Cleanup of the timeout and Fl::wait() code. This one calls the clock
function less than half as much, which resulted in a noticable
improvement in a flip book program I was working on.  The code looks
nicer, too, and I am reasonably certain it works the same.

Fl::wait(time) with a time greater than the system can handle (24.855
days on NT, the same on some Unix systems) will now act as though the
time is infinity.  Before it would do unpredictable things.

"USE_POLL" now compiles and works, although it is disabled by default.
poll() is an alternative to the Unix select() call which is available on
Linux and Irix, but I don't know if it is faster, you can try it by
editing config.h.

I tried making the NT USE_ASYNC_SELECT code do translate/dispatch of
the select events on the assumption (based on experience) that not
doing this to every event gives NT fits.  This appears to work but I'm
not sure if it fixes anything.

X version does not crash if Fl::wait() is called when the display is
closed (it will not return unless you have a timeout or fd callback
set up, though).

Fixed up the documentation for all of this, including getting rid of
some completely misleading documentation.

Now I need to get this stuff into 2.0...


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.0@1215 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2000-06-18 00:38:41 +00:00
..
adjuster1.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
ask.C.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
basics.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
bglogo.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
boxtypes.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
button.C.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
buttons.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
charts.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
choice.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
clock.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
common.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
counter.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
cubeview.gif Added missing GIF for CubeView demo. 1999-02-22 22:13:56 +00:00
dial.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
drawing.html Added Fl::first_window(window) to change which window is at the top of 2000-05-13 20:03:20 +00:00
editor-replace.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
editor.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
editor.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
enumerations.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
events.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
filechooser.gif Final changes for next beta release - typos and more updated images. 1999-01-13 20:55:40 +00:00
Fl_Adjuster.html Updated documentation with changes from Bill. 1999-01-19 20:53:39 +00:00
fl_alert.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
fl_ask.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
Fl_Box.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Browser_.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
Fl_Browser.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
Fl_Button.html Fixes to documentation. 1999-01-27 08:45:11 +00:00
Fl_Chart.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
Fl_Check_Button.gif Added button images for documentation. 1999-01-19 19:29:47 +00:00
Fl_Check_Button.html Updated documentation with changes from Bill. 1999-01-19 20:53:39 +00:00
fl_choice.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
Fl_Choice.html Fixes to documentation. 1999-01-27 08:45:11 +00:00
Fl_Clock.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Color_Chooser.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
fl_color_chooser.jpg Final changes for next beta release - typos and more updated images. 1999-01-13 20:55:40 +00:00
Fl_Counter.html Updated docos to match code. 1999-03-09 18:42:05 +00:00
Fl_Dial.html Changes to dial so that counter-clockwise motion is supported if you 1999-03-10 08:17:43 +00:00
Fl_Double_Window.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_End.html Fixes to documentation. 1999-01-27 08:45:11 +00:00
Fl_Float_Input.html Fixed include files for subclasses of Fl_Input 2000-06-08 07:45:20 +00:00
Fl_Free.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Gl_Window.html Fixes to documentation. 1999-01-27 08:45:11 +00:00
Fl_Group.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
Fl_Hold_Browser.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Input_.html Fixed bug on Win32 where programs would stop paying attention to keys. 1999-12-15 04:58:27 +00:00
fl_input.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
Fl_Input.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
Fl_Int_Input.html Fixed include files for subclasses of Fl_Input 2000-06-08 07:45:20 +00:00
Fl_Light_Button.gif Added button images for documentation. 1999-01-19 19:29:47 +00:00
Fl_Light_Button.html Updated documentation with changes from Bill. 1999-01-19 20:53:39 +00:00
Fl_Menu_.html Changes to Fl_Menu_::add() so that you should be able to add to any menu, 1999-04-19 07:01:24 +00:00
Fl_Menu_Bar.html Fixes to documentation. 1999-01-27 08:45:11 +00:00
Fl_Menu_Button.html Fixes to documentation. 1999-01-27 08:45:11 +00:00
Fl_Menu_Item.html Changes to Fl_Menu_::add() so that you should be able to add to any menu, 1999-04-19 07:01:24 +00:00
Fl_Menu_Window.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
fl_message.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
Fl_Multi_Browser.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Multiline_Input.html Fixed include files for subclasses of Fl_Input 2000-06-08 07:45:20 +00:00
Fl_Multiline_Output.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Output.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Overlay_Window.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Pack.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
fl_password.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
Fl_Positioner.html More image updates, minor typos, etc. 1999-01-14 22:14:01 +00:00
Fl_Repeat_Button.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Return_Button.gif Added button images for documentation. 1999-01-19 19:29:47 +00:00
Fl_Return_Button.html Updated documentation with changes from Bill. 1999-01-19 20:53:39 +00:00
Fl_Roller.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
Fl_Roller.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Round_Button.gif Added button images for documentation. 1999-01-19 19:29:47 +00:00
Fl_Round_Button.html Updated documentation with changes from Bill. 1999-01-19 20:53:39 +00:00
Fl_Scroll.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
Fl_Scroll.html More image updates, minor typos, etc. 1999-01-14 22:14:01 +00:00
Fl_Scrollbar.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Secret_Input.html Fixed include files for subclasses of Fl_Input 2000-06-08 07:45:20 +00:00
Fl_Select_Browser.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
fl_show_colormap.gif Final changes for next beta release - typos and more updated images. 1999-01-13 20:55:40 +00:00
Fl_Single_Window.html More image updates, minor typos, etc. 1999-01-14 22:14:01 +00:00
Fl_Slider.html Added optimization for SGI builds (mike: please run autoconf before making 1999-01-31 07:43:16 +00:00
Fl_Tabs.html Fixed header file name. 1999-01-17 23:17:34 +00:00
Fl_Tile.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
Fl_Tile.html Documentation updates for 1.0.8. 2000-03-15 18:57:07 +00:00
Fl_Timer.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Valuator.html Updated docos to match code. 1999-03-09 18:42:05 +00:00
Fl_Value_Input.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
Fl_Value_Input.html Added optimization for SGI builds (mike: please run autoconf before making 1999-01-31 07:43:16 +00:00
Fl_Value_Output.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
Fl_Value_Output.html Updated all links so they work between files. 1999-01-13 19:28:54 +00:00
Fl_Value_Slider.html More image updates, minor typos, etc. 1999-01-14 22:14:01 +00:00
Fl_Widget.html Fixed bad links. 1999-02-23 14:18:56 +00:00
Fl_Window.html Added Fl::first_window(window) to change which window is at the top of 2000-05-13 20:03:20 +00:00
FL.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
fluid1.gif Updated Fl_Browser documentation 1999-01-30 17:30:09 +00:00
fluid2.gif Updated Fl_Browser documentation 1999-01-30 17:30:09 +00:00
fluid3.gif Updated Fl_Browser documentation 1999-01-30 17:30:09 +00:00
fluid4.gif Updated Fl_Browser documentation 1999-01-30 17:30:09 +00:00
fluid_main.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
fluid_prefs.gif Dropped use of -fomit-frame-pointer, as I've just discovered that it 2000-04-27 00:17:54 +00:00
fluid_widget.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
fluid-catgets.gif Dropped use of -fomit-frame-pointer, as I've just discovered that it 2000-04-27 00:17:54 +00:00
fluid-gettext.gif Dropped use of -fomit-frame-pointer, as I've just discovered that it 2000-04-27 00:17:54 +00:00
fluid-org.gif Fixed various typos and added a Fluid organization chart image 1999-01-13 15:35:04 +00:00
fluid.1 Updated copyright notices for all of the 1.0.x files. 2000-04-25 22:17:00 +00:00
fluid.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
fluid.html Added a bunch of missing FL_EXTERN's to glut.h (I have not really 2000-06-15 05:37:40 +00:00
fluid.man Updated copyright notices for all of the 1.0.x files. 2000-04-25 22:17:00 +00:00
forms.html More image updates, minor typos, etc. 1999-01-14 22:14:01 +00:00
functions.html Cleanup of the timeout and Fl::wait() code. This one calls the clock 2000-06-18 00:38:41 +00:00
glut.html Documentation updates for 1.0.8. 2000-03-15 18:57:07 +00:00
hello.C.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
index.html OK, now version 1.0.9 2000-06-05 21:21:24 +00:00
intro.html OK, now version 1.0.9 2000-06-05 21:21:24 +00:00
license.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
Makefile OK, now version 1.0.9 2000-06-05 21:21:24 +00:00
menu_button.gif More image updates, minor typos, etc. 1999-01-14 22:14:01 +00:00
menu.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
menubar.gif More image updates, minor typos, etc. 1999-01-14 22:14:01 +00:00
opengl.html Documentation updates for 1.0.8. 2000-03-15 18:57:07 +00:00
osissues.html Documentation updates for 1.0.8. 2000-03-15 18:57:07 +00:00
positioner.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
preface.html OK, now version 1.0.9 2000-06-05 21:21:24 +00:00
README Documentation update. 1999-01-13 16:25:17 +00:00
resizebox1.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
resizebox2.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
round_clock.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
scrollbar.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
shape.C.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
slider.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
subclassing.html Typos reported by Alexander Mai 2000-04-28 18:15:26 +00:00
symbols.gif Updated symbols image, and fixed a few more typos. 1999-01-27 14:24:00 +00:00
tabs.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
text.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
valuators.gif Updated screenshots for current release. 1999-01-13 20:12:41 +00:00
value_slider.gif More image updates, minor typos, etc. 1999-01-14 22:14:01 +00:00
widgets.html Added optimization for SGI builds (mike: please run autoconf before making 1999-01-31 07:43:16 +00:00

README
------

The documentation in this directory is in HTML format.  To read it just
point your browser at the "index.html" file. A slightly more browseable
version is accessable at the FLTK web site, along with PostScript(tm)
and PDF versions of the manual.

You can generate your own (printable) copy of the manual by typing
"make" in this directory.  You will need to have the HTMLDOC software
installed on your system.  HTMLDOC can be downloaded from:

    http://www.easysw.com/~mike/htmldoc

The default media size is 8.27x11.0" (210x279mm), which is the lesser
of A4 and US Letter sizes.  You can change this in the makefile by
uncommenting the corresponding media size or defining your own.

If you find any typos, things that are unclear, or would like to
contribute an example, section, or chapter to the FLTK manual, please
contact Michael Sweet (mike@easysw.com).