mirrors/fltk
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
1df4a9fb4a
fltk/documentation
History
Matthias Melcher c9908d97e3 THIS FIX CONTAINS TWO MORE FILES THAT MUST BE COMPILED. I would 
like to ask the maintainers of the build environments to please
add these files to the setup:

  src/fl_encoding_latin1.cxx
  src/fl_encoding_mac_roman.cxx

I ADDED SOME DOCUMENTATION THAT NEEDS TO BE FIXED. Beeing not a
native English speaker, I have a hard time writing documentation.
Would someone please update my babbeling in 
documentation/drawing.html? Thanks.

This commit fixes some very basic problems with OS X's code page in
preparation for the compose-character keyboard fix. It also fixes
issues with MS Windows and X11 not rendering the characters
in the Western (Latin-1) set between 0x80 and 0x9F. In the original
ISO font, they were unused, but are now assigned to international
characters like the Euro currency sign.

This patch also tries to fix one basic flaw with FLTK 1 and
font encoding. I will not put much more work into this because
FLTK 1.2 and FLTK 2 fix the problem entirely by using UTF-8
instead of 8-bit "C"-style strings.

All these changes are only meaningful for foreign language
users or users of special characters like the Euro, the Degree
or the Permille symbol. A short explanation follows.

Max OS X uses a different code page than X11 and Win32. This means
that all characters above 0x7f have an entirely different meaning.
If your source code contains international characters, your 
text will appear different if you change to another OS. This patch
provides two functions that convert text with international
characters from the character set of the source code into the
local character set. Two more functions are provided to convert
them back. The functions are fl_latin1_to_local (source is in Win32 
or X11), fl_mac_roman_to_local (source was written on OS X) and the 
corresponding fl_local_to_latin1 and fl_local_to_mac_roman, which
are very useful if yoou want to store strings with intl. characters
that will be moved between systems.

All this is assuming a "Western" code page as it is common in
the Americas and most of Europe. User of other languages will have 
to use FLTK 2.



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4975 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2006-04-18 13:07:42 +00:00
..
adjuster1.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
basics.html Final doco updates for 1.1.0. 2002-10-04 17:23:09 +00:00
boxtypes.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
buttons.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
charts.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
checkers.man More packaging fun. 2006-01-15 18:36:16 +00:00
choice.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
clock.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
common.html git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4720 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 2005-12-19 13:33:08 +00:00
counter.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
cubeview.gif Finish changes to FLUID chapter... 2002-03-24 21:51:32 +00:00
dial.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
drawing.html THIS FIX CONTAINS TWO MORE FILES THAT MUST BE COMPILED. I would 2006-04-18 13:07:42 +00:00
editor-replace.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
editor.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
editor.html Add section on the main() function to the editor example. 2002-10-22 20:08:37 +00:00
enumerations.html Added documentation for all forms of Fl_Widget::damage() (STR 2003-06-12 01:36:18 +00:00
events.html Final doco updates for 1.1.0. 2002-10-04 17:23:09 +00:00
examples.html Remove DOS line endings from text files. 2005-11-02 19:06:55 +00:00
Fl_Adjuster.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
fl_alert.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
fl_ask.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Bitmap.html Image class docos. 2001-11-27 04:55:48 +00:00
Fl_BMP_Image.html Move Fl_Help_Dialog to fltk_images library. 2002-09-16 01:35:34 +00:00
Fl_Box.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Browser_.html More browser documentation changes. 2005-03-05 19:31:42 +00:00
Fl_Browser.html More documentation updates... 2004-07-26 20:52:52 +00:00
Fl_Button.html Str 1171: added documentation for Fl_Toggle_Button 2006-03-29 14:40:44 +00:00
Fl_Chart.html Position 1 is the first element in a chart, not 0. 2003-01-27 21:08:41 +00:00
Fl_Check_Browser.html Documentation updates. 2002-10-07 13:19:22 +00:00
Fl_Check_Button.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Check_Button.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
fl_choice.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Choice.html Clarify Fl_Choice callback description (STR #692) 2005-02-06 00:12:15 +00:00
Fl_Clock_Output.html STR 1192: Added documentation for Fl_Clock_Output 2006-03-28 23:53:15 +00:00
Fl_Clock.html STR 1192: Added documentation for Fl_Clock_Output 2006-03-28 23:53:15 +00:00
Fl_Color_Chooser.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
fl_color_chooser.jpg Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Counter.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Dial.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Double_Window.html Documentation updates (STR #570) 2004-10-18 20:22:25 +00:00
Fl_End.html Add Fl::version() and Fl::event() methods. 2001-11-28 18:00:17 +00:00
Fl_File_Browser.html Add sort function as optional argument to Fl_File_Browser::load(). 2002-05-02 14:31:10 +00:00
Fl_File_Chooser.html Remove Fl_Group from Fl_File_Chooser docos. 2005-08-08 02:46:20 +00:00
Fl_File_Chooser.jpg New file chooser. 2002-06-07 15:06:32 +00:00
Fl_File_Icon.html Fl_FileXYZ -> Fl_File_XYZ 2001-09-29 14:38:59 +00:00
Fl_File_Input.gif Add docos for Fl_File_Input. 2002-05-01 00:55:45 +00:00
Fl_File_Input.html Add docos for Fl_File_Input. 2002-05-01 00:55:45 +00:00
Fl_Float_Input.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Free.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_GIF_Image.html Move Fl_Help_Dialog to fltk_images library. 2002-09-16 01:35:34 +00:00
Fl_Gl_Window.html Move Fl_Help_Dialog to fltk_images library. 2002-09-16 01:35:34 +00:00
Fl_Group.html Documentation updates (STR #505, STR #513) 2004-09-07 20:59:18 +00:00
Fl_Help_Dialog.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Help_Dialog.html Added Help_Dialog::value() to the help page. 2005-09-25 17:04:29 +00:00
Fl_Help_View.html Doco and makefile updates from SGI. 2002-01-15 02:17:19 +00:00
Fl_Hold_Browser.html Update browser docos; value(0) doesn't do anything, only deselect() clears 2003-01-27 21:05:22 +00:00
Fl_Image.html git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4720 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 2005-12-19 13:33:08 +00:00
Fl_Input_.html More documentation updates... 2004-07-26 20:52:52 +00:00
Fl_Input_Choice.html Added Greg Ercolano's simple Fl_Input_Choice widget which is a 2005-02-24 21:14:22 +00:00
fl_input.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Input.html Fix link errors. 2002-05-10 15:42:44 +00:00
Fl_Int_Input.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_JPEG_Image.html Move Fl_Help_Dialog to fltk_images library. 2002-09-16 01:35:34 +00:00
Fl_Light_Button.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Light_Button.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Menu_.html Fl_Menu_::find_item() was trying to search through submenus created with FL_SUBMENU_POINTER (vs. Fl_SUBMENU and an array of submenu items), but not following the pointer, messing up the search string. 2005-05-31 20:05:50 +00:00
Fl_Menu_Bar.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Menu_Button.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Menu_Item.html Doco and makefile updates from SGI. 2002-01-15 02:17:19 +00:00
Fl_Menu_Window.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
fl_message.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Multi_Browser.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Multiline_Input.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Multiline_Output.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Output.html Make Fl_Output a subclass of Fl_Input, and add input_type and readonly 2002-04-11 11:52:43 +00:00
Fl_Overlay_Window.html Fix links in FLTK docos. 2002-02-13 03:33:53 +00:00
Fl_Pack.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
fl_password.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Pixmap.html Image class docos. 2001-11-27 04:55:48 +00:00
Fl_PNG_Image.html Move Fl_Help_Dialog to fltk_images library. 2002-09-16 01:35:34 +00:00
Fl_PNM_Image.html Move Fl_Help_Dialog to fltk_images library. 2002-09-16 01:35:34 +00:00
Fl_Positioner.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Preferences.html More documentation updates... 2004-07-26 20:52:52 +00:00
Fl_Progress.html Add missing docos for Fl_Progress. 2002-04-18 20:37:29 +00:00
Fl_Repeat_Button.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Return_Button.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Return_Button.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_RGB_Image.html One typo, one missing link 2005-10-26 09:48:39 +00:00
Fl_Roller.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Roller.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Round_Button.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Round_Button.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Scroll.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Scroll.html Prefer fl_push_clip() over fl_clip(). 2002-06-11 20:58:12 +00:00
Fl_Scrollbar.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Secret_Input.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Select_Browser.html Update browser docos; value(0) doesn't do anything, only deselect() clears 2003-01-27 21:05:22 +00:00
Fl_Shared_Image.html Doco updates. 2002-08-12 19:44:59 +00:00
fl_show_colormap.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Single_Window.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Slider.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Spinner.html Change Fl_Spinner to use double values instead of ints. 2005-03-25 02:39:25 +00:00
Fl_Tabs.html Add missing color function documentation. 2002-07-25 12:46:12 +00:00
Fl_Text_Buffer.html Documentation update for Fl_Text_Buffer. 2005-04-04 06:29:26 +00:00
Fl_Text_Display.html Added documentation for Fl_Text_Display::wrap_mode which seems to work well enough in the editor demo. 2005-07-14 14:42:00 +00:00
Fl_Text_Editor.html Final doco updates for 1.1.0. 2002-10-04 17:23:09 +00:00
Fl_Tile.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Tile.html Update tile documentation to be explicit about widgets touching and doing 2002-10-30 14:23:16 +00:00
Fl_Tiled_Image.html One typo, one missing link 2005-10-26 09:48:39 +00:00
Fl_Timer.html Doco and makefile updates from SGI. 2002-01-15 02:17:19 +00:00
Fl_Toggle_Button.html Str 1171: added documentation for Fl_Toggle_Button 2006-03-29 14:40:44 +00:00
Fl_Tooltip.html Add Fl_Tooltip::hoverdelay() method and code (STR #126) 2003-09-14 14:11:06 +00:00
Fl_Valuator.html STR 1167: updated documentation for Fl_Valuator and Fl_Value_Input 2006-03-29 14:54:39 +00:00
Fl_Value_Input.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Value_Input.html STR 1167: updated documentation for Fl_Valuator and Fl_Value_Input 2006-03-29 14:54:39 +00:00
Fl_Value_Output.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
Fl_Value_Output.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Value_Slider.html Documentation updates galore (up to chapter 7, still need to do chapter 2001-11-29 19:24:00 +00:00
Fl_Widget.html STR 1192: Added documentation for Fl_Clock_Output 2006-03-28 23:53:15 +00:00
Fl_Window.html Documentation fix (STR #648) 2005-02-05 20:35:51 +00:00
Fl_Wizard.html Doco and makefile updates from SGI. 2002-01-15 02:17:19 +00:00
Fl_XBM_Image.html Move Fl_Help_Dialog to fltk_images library. 2002-09-16 01:35:34 +00:00
Fl_XPM_Image.html Move Fl_Help_Dialog to fltk_images library. 2002-09-16 01:35:34 +00:00
FL.gif Update copyright in FLUID "about" window. 2002-02-20 13:02:27 +00:00
Fl.html git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4720 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 2005-12-19 13:33:08 +00:00
fltk-config.man Add --cc and --cxx options to fltk-config, which show the compilers that 2005-08-08 15:08:06 +00:00
fltk.book Str 1171: added documentation for Fl_Toggle_Button 2006-03-29 14:40:44 +00:00
fltk.man Doco and dist file updates. 2002-01-06 13:40:32 +00:00
fluid1.gif Working on the FLUID chapter, to do a new FLTK 1.1.0 beta release... 2002-03-22 22:40:10 +00:00
fluid2.gif Working on the FLUID chapter, to do a new FLTK 1.1.0 beta release... 2002-03-22 22:40:10 +00:00
fluid3-cxx.gif Working on the FLUID chapter, to do a new FLTK 1.1.0 beta release... 2002-03-22 22:40:10 +00:00
fluid3-gui.gif Working on the FLUID chapter, to do a new FLTK 1.1.0 beta release... 2002-03-22 22:40:10 +00:00
fluid3-style.gif Working on the FLUID chapter, to do a new FLTK 1.1.0 beta release... 2002-03-22 22:40:10 +00:00
fluid4.gif Working on the FLUID chapter, to do a new FLTK 1.1.0 beta release... 2002-03-22 22:40:10 +00:00
fluid_prefs.gif Doco updates for 1.1. 2002-03-24 17:26:00 +00:00
fluid_widget_cxx.gif Doco updates for 1.1. 2002-03-24 17:26:00 +00:00
fluid_widget_gui.gif Doco updates for 1.1. 2002-03-24 17:26:00 +00:00
fluid_widget_style.gif Doco updates for 1.1. 2002-03-24 17:26:00 +00:00
fluid-catgets.gif Doco updates for 1.1. 2002-03-24 17:26:00 +00:00
fluid-gettext.gif Doco updates for 1.1. 2002-03-24 17:26:00 +00:00
fluid-org.gif Fixed various typos and added a Fluid organization chart image 1999-01-13 15:35:04 +00:00
fluid.html Update some FLUID documentation, no snapshots though. 2002-05-02 04:23:33 +00:00
fluid.man Doco and dist file updates. 2002-01-06 13:40:32 +00:00
forms.html More doco updates. 2004-07-27 16:02:21 +00:00
functions.html This change is controversial. It changes the behavior of fl_filename_list 2005-08-17 21:56:22 +00:00
glut.html GLUT_STEREO is too implemented! :) 2003-01-30 15:48:24 +00:00
hello.C.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
index.html Update copyright. 2006-01-15 02:22:54 +00:00
input_choice.jpg Added Greg Ercolano's simple Fl_Input_Choice widget which is a 2005-02-24 21:14:22 +00:00
intro.html STR #1102: Typo 2005-12-12 23:28:12 +00:00
license.html Update paragraph 4 of the FLTK license exemptions; basically, justify/ 2001-12-12 02:20:15 +00:00
Makefile More packaging fun. 2006-01-15 18:36:16 +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 Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
migration.html git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4720 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 2005-12-19 13:33:08 +00:00
opengl.html Doco updates for 1.1. 2002-03-24 17:26:00 +00:00
osissues.html Doco update for subwindows on OSX, and remove WIN32 note for cut/paste 2005-08-08 03:03:37 +00:00
positioner.gif Revised documentation files. 1998-12-29 14:21:17 +00:00
preface.html Update copyright. 2006-01-15 02:22:54 +00:00
README Configure script changes to support man pages, HTMLDOC, AIX/QNX with 2001-02-12 15:12:14 +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 Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
slider.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
subclassing.html git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4720 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 2005-12-19 13:33:08 +00:00
sudoku.man More packaging fun. 2006-01-15 18:36:16 +00:00
symbols.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
tabs.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
text.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
valuators.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
value_slider.gif Update documentation screenshots (still have some to go...) 2001-12-12 21:33:34 +00:00
widgets.html Str 1171: added documentation for Fl_Toggle_Button 2006-03-29 14:40:44 +00:00

README 

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