From c95505b4621f88a364abff8d2807a204896ffcd1 Mon Sep 17 00:00:00 2001 From: engelsman Date: Wed, 25 Mar 2009 23:12:48 +0000 Subject: removed numbering from doxygen chapters and navigation bars, moved class/function reference pages to end of index table, swapped editor/drawing chapters in Doxybook for PDF version git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6721 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 --- documentation/Doxybook | 8 +++--- documentation/Doxyfile | 2 +- documentation/Makefile | 2 +- documentation/src/advanced.dox | 6 ++--- documentation/src/basics.dox | 6 ++--- documentation/src/common.dox | 6 ++--- documentation/src/development.dox | 2 +- documentation/src/drawing.dox | 6 ++--- documentation/src/editor.dox | 6 ++--- documentation/src/enumerations.dox | 4 +-- documentation/src/events.dox | 6 ++--- documentation/src/examples.dox | 2 +- documentation/src/fluid.dox | 6 ++--- documentation/src/forms.dox | 2 +- documentation/src/glut.dox | 2 +- documentation/src/index.dox | 52 +++++++++++++++++++++---------------- documentation/src/intro.dox | 4 +-- documentation/src/license.dox | 2 +- documentation/src/migration_1_1.dox | 2 +- documentation/src/migration_1_3.dox | 2 +- documentation/src/opengl.dox | 6 ++--- documentation/src/osissues.dox | 2 +- documentation/src/preface.dox | 9 ++++--- documentation/src/subclassing.dox | 2 +- documentation/src/unicode.dox | 6 ++--- 25 files changed, 82 insertions(+), 71 deletions(-) (limited to 'documentation') diff --git a/documentation/Doxybook b/documentation/Doxybook index d863ee562..6d884e128 100755 --- a/documentation/Doxybook +++ b/documentation/Doxybook @@ -557,16 +557,14 @@ INPUT = src/index.dox \ src/intro.dox \ src/basics.dox \ src/common.dox \ - src/drawing.dox \ src/editor.dox \ + src/drawing.dox \ src/events.dox \ src/subclassing.dox \ src/opengl.dox \ src/fluid.dox \ src/advanced.dox \ src/unicode.dox \ - ../FL \ - ../src \ src/enumerations.dox \ src/glut.dox \ src/forms.dox \ @@ -575,7 +573,9 @@ INPUT = src/index.dox \ src/migration_1_3.dox \ src/development.dox \ src/license.dox \ - src/examples.dox + src/examples.dox \ + ../FL \ + ../src # This tag can be used to specify the character encoding of the source files # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is diff --git a/documentation/Doxyfile b/documentation/Doxyfile index bfc6f3356..7f56a8c9b 100644 --- a/documentation/Doxyfile +++ b/documentation/Doxyfile @@ -557,8 +557,8 @@ INPUT = src/index.dox \ src/intro.dox \ src/basics.dox \ src/common.dox \ - src/drawing.dox \ src/editor.dox \ + src/drawing.dox \ src/events.dox \ src/subclassing.dox \ src/opengl.dox \ diff --git a/documentation/Makefile b/documentation/Makefile index dd1256676..219055d1b 100644 --- a/documentation/Makefile +++ b/documentation/Makefile @@ -49,8 +49,8 @@ HTMLFILES = \ $(SRC_DOCDIR)/intro.dox \ $(SRC_DOCDIR)/basics.dox \ $(SRC_DOCDIR)/common.dox \ - $(SRC_DOCDIR)/drawing.dox \ $(SRC_DOCDIR)/editor.dox \ + $(SRC_DOCDIR)/drawing.dox \ $(SRC_DOCDIR)/events.dox \ $(SRC_DOCDIR)/subclassing.dox \ $(SRC_DOCDIR)/opengl.dox \ diff --git a/documentation/src/advanced.dox b/documentation/src/advanced.dox index 4afc929b4..5df80bc30 100644 --- a/documentation/src/advanced.dox +++ b/documentation/src/advanced.dox @@ -1,6 +1,6 @@ /** - \page advanced 10 - Advanced FLTK + \page advanced Advanced FLTK This chapter explains advanced programming and design topics that will help you to get the most out of FLTK. @@ -103,7 +103,7 @@ Fl::unlock(). \htmlonly
[Index]    -[Previous]  9 - Programming with FLUID  -[Next]  11 - Unicode and utf-8 Support  +[Previous]  Programming with FLUID  +[Next]  Unicode and utf-8 Support  \endhtmlonly */ diff --git a/documentation/src/basics.dox b/documentation/src/basics.dox index 1af6058fb..5f02ebaf2 100644 --- a/documentation/src/basics.dox +++ b/documentation/src/basics.dox @@ -1,6 +1,6 @@ /** - \page basics 2 - FLTK Basics + \page basics FLTK Basics This chapter teaches you the basics of compiling programs that use FLTK. @@ -376,7 +376,7 @@ include lines: \htmlonly
[Index]    -[Previous]  1 - Introduction to FLTK  -[Next]  3 - Common Widgets and Attributes  +[Previous]  Introduction to FLTK  +[Next]  Common Widgets and Attributes  \endhtmlonly */ diff --git a/documentation/src/common.dox b/documentation/src/common.dox index ab0e43c98..dbc0bfa5e 100644 --- a/documentation/src/common.dox +++ b/documentation/src/common.dox @@ -1,6 +1,6 @@ /** - \page common 3 - Common Widgets and Attributes + \page common Common Widgets and Attributes This chapter describes many of the widgets that are provided with FLTK and covers how to query and set the standard @@ -589,8 +589,8 @@ combined with any modifiers like \c Shift , \c Alt , and \c Control . \htmlonly
[Index]    -[Previous]  2 - FLTK Basics  -[Next]  4 - Designing a Simple Text Editor  +[Previous]  FLTK Basics  +[Next]  Designing a Simple Text Editor  \endhtmlonly */ diff --git a/documentation/src/development.dox b/documentation/src/development.dox index d4f0efa13..5f2169530 100644 --- a/documentation/src/development.dox +++ b/documentation/src/development.dox @@ -1,6 +1,6 @@ /** - \page development I - Developer Information + \page development Developer Information This chapter describes FLTK development and documentation. diff --git a/documentation/src/drawing.dox b/documentation/src/drawing.dox index 5e701f7ba..ec61e05dc 100644 --- a/documentation/src/drawing.dox +++ b/documentation/src/drawing.dox @@ -1,6 +1,6 @@ /** - \page drawing 5 - Drawing Things in FLTK + \page drawing Drawing Things in FLTK This chapter covers the drawing functions that are provided with FLTK. @@ -1004,7 +1004,7 @@ in the offscreen buffer into the current buffer at x, y. \htmlonly
[Index]    -[Previous]  4 - Designing a Simple Text Editor  -[Next]  6 - Handling Events  +[Previous]  Designing a Simple Text Editor  +[Next]  Handling Events  \endhtmlonly */ diff --git a/documentation/src/editor.dox b/documentation/src/editor.dox index 51fd40047..5898b9380 100644 --- a/documentation/src/editor.dox +++ b/documentation/src/editor.dox @@ -1,6 +1,6 @@ /** - \page editor 4 - Designing a Simple Text Editor + \page editor Designing a Simple Text Editor This chapter takes you through the design of a simple FLTK-based text editor. @@ -894,7 +894,7 @@ style_parse(const char *text, \htmlonly
[Index]    -[Previous]  3 - Common Widgets and Attributes  -[Next]  5 - Drawing Things in FLTK  +[Previous]  Common Widgets and Attributes  +[Next]  Drawing Things in FLTK  \endhtmlonly */ diff --git a/documentation/src/enumerations.dox b/documentation/src/enumerations.dox index 5577da6d3..c42d0647c 100644 --- a/documentation/src/enumerations.dox +++ b/documentation/src/enumerations.dox @@ -1,6 +1,6 @@ /** - \page enumerations C - FLTK Enumerations + \page enumerations FLTK Enumerations \note This file is not actively maintained any more, but is left here as a reference, until the doxygen documentation is @@ -293,7 +293,7 @@ The following damage mask bits are used by the standard FLTK widgets: \htmlonly
[Index]    -[Previous] Function Reference  +[Previous] Unicode and UTF-8 Support  [Next] GLUT Compatibility  \endhtmlonly */ diff --git a/documentation/src/events.dox b/documentation/src/events.dox index 8728732bb..80c6df7a7 100644 --- a/documentation/src/events.dox +++ b/documentation/src/events.dox @@ -1,6 +1,6 @@ /** - \page events 6 - Handling Events + \page events Handling Events This chapter discusses the FLTK event model and how to handle events in your program or widget. @@ -398,7 +398,7 @@ The following methods are provided for character composition: \htmlonly
[Index]    -[Previous]  5 - Drawing Things in FLTK  : -[Next]  7 - Adding and Extending Widgets +[Previous]  Drawing Things in FLTK  : +[Next]  Adding and Extending Widgets \endhtmlonly */ diff --git a/documentation/src/examples.dox b/documentation/src/examples.dox index 0141acacc..ad3e6de84 100644 --- a/documentation/src/examples.dox +++ b/documentation/src/examples.dox @@ -1,6 +1,6 @@ /** - \page examples K - Example Source Code + \page examples Example Source Code \par March 19, 2005 diff --git a/documentation/src/fluid.dox b/documentation/src/fluid.dox index 1ed3a1eb6..a83bfc1dd 100644 --- a/documentation/src/fluid.dox +++ b/documentation/src/fluid.dox @@ -3,7 +3,7 @@ - \page fluid 9 - Programming with FLUID + \page fluid Programming with FLUID This chapter shows how to use the Fast Light User-Interface Designer ("FLUID") to create your GUIs. @@ -1389,7 +1389,7 @@ be generated and likely cause compile-time warnings. \htmlonly
[Index]    -[Previous]  8 - Using OpenGL    -[Next]  10 - Advanced FLTK +[Previous]  Using OpenGL    +[Next]  Advanced FLTK \endhtmlonly */ diff --git a/documentation/src/forms.dox b/documentation/src/forms.dox index bd7796726..45dbfc32a 100644 --- a/documentation/src/forms.dox +++ b/documentation/src/forms.dox @@ -1,6 +1,6 @@ /** - \page forms E - Forms Compatibility + \page forms Forms Compatibility This appendix describes the Forms compatibility included with FLTK. diff --git a/documentation/src/glut.dox b/documentation/src/glut.dox index 0298a329e..09958f767 100644 --- a/documentation/src/glut.dox +++ b/documentation/src/glut.dox @@ -1,6 +1,6 @@ /** - \page glut D - GLUT Compatibility + \page glut GLUT Compatibility This appendix describes the GLUT compatibility header file supplied with FLTK. FLTK's GLUT compatibility is based on the original GLUT 3.7 and diff --git a/documentation/src/index.dox b/documentation/src/index.dox index 83a11aab0..699bf3d61 100644 --- a/documentation/src/index.dox +++ b/documentation/src/index.dox @@ -36,27 +36,27 @@ \subpage basics \subpage common - \li \ref drawing_colors - \li \ref common_boxtypes - \li \ref common_labels - \li \ref drawing_images + - \ref drawing_colors + - \ref common_boxtypes + - \ref common_labels + - \ref drawing_images \subpage editor \subpage drawing \subpage events - \li \ref events_event_xxx - \li \ref events_propagation + - \ref events_event_xxx + - \ref events_propagation \subpage subclassing \subpage opengl \subpage fluid - \li \ref fluid_widget_attributes - \li \ref fluid_selecting_moving - \li \ref fluid_images + - \ref fluid_widget_attributes + - \ref fluid_selecting_moving + - \ref fluid_images @@ -65,34 +65,42 @@ \subpage unicode - A - Class Reference + Appendices: + + - \subpage enumerations - B - Function Reference + - \subpage glut + - \ref glut_Fl_Glut_Window + - \subpage enumerations + - \subpage forms - \subpage glut - \li \ref glut_Fl_Glut_Window - + - \subpage osissues - \subpage forms + - \subpage migration_1_1 - \subpage osissues + - \subpage migration_1_3 - \subpage migration_1_1 + - \subpage development - \subpage migration_1_3 + - \subpage license - \subpage development + - \subpage examples - \subpage license + References: - \subpage examples + - Class Reference + + - Function Reference +\todo The Index link in the html navigation bar needs to be removed + or reconfigured as it creates a nested frame in firefox/linux + whereas the MainPage tab at the top of the page works properly. + \htmlonly
[Index]    diff --git a/documentation/src/intro.dox b/documentation/src/intro.dox index 4fdc52860..0af053fe5 100644 --- a/documentation/src/intro.dox +++ b/documentation/src/intro.dox @@ -1,6 +1,6 @@ /** - \page intro 1 - Introduction to FLTK + \page intro Introduction to FLTK The Fast Light Tool Kit ("FLTK", pronounced "fulltick") is a cross-platform C++ GUI toolkit for @@ -350,6 +350,6 @@ at "fltk@fltk.org" or one of the newsgroups.
[Index]    [Previous] Preface    -[Next]  2 - FLTK Basics +[Next]  FLTK Basics \endhtmlonly */ diff --git a/documentation/src/license.dox b/documentation/src/license.dox index f1ae144c7..68b690320 100644 --- a/documentation/src/license.dox +++ b/documentation/src/license.dox @@ -1,6 +1,6 @@ /** - \page license J - Software License + \page license Software License \par December 11, 2001 diff --git a/documentation/src/migration_1_1.dox b/documentation/src/migration_1_1.dox index 5abd94d9a..67615c889 100644 --- a/documentation/src/migration_1_1.dox +++ b/documentation/src/migration_1_1.dox @@ -1,6 +1,6 @@ /** - \page migration_1_1 G - Migrating Code from FLTK 1.0 to 1.1 + \page migration_1_1 Migrating Code from FLTK 1.0 to 1.1 This appendix describes the differences between the FLTK diff --git a/documentation/src/migration_1_3.dox b/documentation/src/migration_1_3.dox index b812d2125..cf5bfdb45 100644 --- a/documentation/src/migration_1_3.dox +++ b/documentation/src/migration_1_3.dox @@ -1,6 +1,6 @@ /** - \page migration_1_3 H - Migrating Code from FLTK 1.1 to 1.3 + \page migration_1_3 Migrating Code from FLTK 1.1 to 1.3 This appendix describes the differences between the FLTK 1.1.x and FLTK 1.3.x functions and classes. diff --git a/documentation/src/opengl.dox b/documentation/src/opengl.dox index cc88f089f..e1eaa4969 100644 --- a/documentation/src/opengl.dox +++ b/documentation/src/opengl.dox @@ -1,6 +1,6 @@ /** - \page opengl 8 - Using OpenGL + \page opengl Using OpenGL This chapter discusses using FLTK for your OpenGL applications. @@ -460,7 +460,7 @@ after this call. \htmlonly
[Index]    -[Previous]  7 - Adding and Extending Widgets  -[Next]  9 - Programming with FLUID  +[Previous]  Adding and Extending Widgets  +[Next]  Programming with FLUID  \endhtmlonly */ diff --git a/documentation/src/osissues.dox b/documentation/src/osissues.dox index 628d41013..5029a55f9 100644 --- a/documentation/src/osissues.dox +++ b/documentation/src/osissues.dox @@ -1,6 +1,6 @@ /** - \page osissues F - Operating System Issues + \page osissues Operating System Issues This appendix describes the operating system specific interfaces in FLTK. diff --git a/documentation/src/preface.dox b/documentation/src/preface.dox index bc3c8e5cf..321a61aba 100644 --- a/documentation/src/preface.dox +++ b/documentation/src/preface.dox @@ -28,8 +28,6 @@ This manual is organized into the following chapters and appendices: \li \ref fluid \li \ref advanced \li \ref unicode -\li A - Class Reference -\li B - Function Reference \li \ref enumerations \li \ref glut \li \ref forms @@ -39,6 +37,10 @@ This manual is organized into the following chapters and appendices: \li \ref development \li \ref license \li \ref examples +\li Class Reference +\li Function Reference +\todo Remove or reconfigure old HTML links as these are relative + to the source directories and fail in the PDF version! \section preface_conventions Conventions @@ -46,6 +48,7 @@ The following typeface conventions are used in this manual: \li Function and constant names are shown in bold courier type \li Code samples and commands are shown in regular courier type +\todo The old typeface conventions need to be rethought for doxygen. \section preface_abbreviations Abbreviations @@ -78,7 +81,7 @@ registered trademarks of Apple Computer, Inc. \htmlonly
[Index]    -[Next] 1 - Introduction to FLTK +[Next] Introduction to FLTK \endhtmlonly */ diff --git a/documentation/src/subclassing.dox b/documentation/src/subclassing.dox index 684833d6f..f25881311 100644 --- a/documentation/src/subclassing.dox +++ b/documentation/src/subclassing.dox @@ -1,6 +1,6 @@ /** - \page subclassing 7 - Adding and Extending Widgets + \page subclassing Adding and Extending Widgets This chapter describes how to add your own widgets or extend existing diff --git a/documentation/src/unicode.dox b/documentation/src/unicode.dox index f352be652..559bfe5a9 100644 --- a/documentation/src/unicode.dox +++ b/documentation/src/unicode.dox @@ -1,6 +1,6 @@ /** - \page unicode 11 - Unicode and utf-8 Support + \page unicode Unicode and utf-8 Support This chapter explains how FLTK handles international text via Unicode and utf-8. @@ -77,7 +77,7 @@ system, FLTK will convert string as needed. \htmlonly
[Index]    -[Previous]  10 - Advanced FLTK   -[Next]  A - Class Reference +[Previous]  Advanced FLTK   +[Next]  FLTK Enumerations \endhtmlonly */ -- cgit v1.2.3