Doxygen documentation - WP12 and WP13 - first step.

Converted the descriptive chapters of the html docs to doxygen format
and modified index.dox accordingly.

This checkin includes only trivial reformatting, no major rewriting.

Added a chapter "Migrating Code from FLTK 1.1 to 1.3".

All links on the main page are working now.

Todo:
  - Check doxygen error messages, rewrite pages (html tags, contents).
  - Fill the new "Migrating..." chapter.


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

1 files changed, 51 insertions, 53 deletions

diff --git a/documentation/index.dox b/documentation/index.dox
index 8253ce735..b4273c556 100644
--- a/documentation/index.dox
+++ b/documentation/index.dox
@@ -19,18 +19,16 @@
 
 <TABLE BGCOLOR="#9f9fef" CELLPADDING="8" CELLSPACING="0" SUMMARY="Table of Contents" WIDTH="700">
 <TR>
-	<TD ALIGN="LEFT" VALIGN="TOP"><B>
+	<TD ALIGN="LEFT" VALIGN="TOP">
+
  \subpage preface
-        </B>
-	<BR>
-	<BR>
-	<B><A HREF="intro.html#intro">1 - Introduction to FLTK</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="basics.html#basics">2 - FLTK Basics</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="common.html#common">3 - Common Widgets and Attributes</A></B>
+
+ \subpage intro
+
+ \subpage basics
+
+ \subpage common
+	<B>
 	<UL>
 	<LI><A HREF="drawing.html#colors">Colors</A></LI>
 	<LI><A HREF="common.html#boxtypes">Box Types</A></LI>
@@ -38,66 +36,66 @@
 	<LI><A HREF="drawing.html#images">Images</A></LI>
 	<LI><A HREF="Fl_Pixmap.html#Fl_Pixmap">class Fl_Pixmap</A></LI>
 	</UL>
-	<B><A HREF="editor.html#editor">4 - Designing a Simple Text Editor</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="drawing.html#drawing">5 - Drawing Things in FLTK</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="events.html#events">6 - Handling Events</A></B>
+	</B>
+
+ \subpage editor
+
+ \subpage drawing
+
+ \subpage events
+ 	<B>
 	<UL>
 	<LI><A HREF="events.html#event_xxx">Fl::event_*() methods</A></LI>
 	<LI><A HREF="events.html#propagation">Event Propagation</A></LI>
 	</UL>
-	<B><A HREF="subclassing.html#subclassing">7 - Adding and Extending
-	Widgets</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="opengl.html#opengl">8 - Using OpenGL</A></B>
+	</B>
+
+ \subpage subclassing
+
+ \subpage opengl
+
 	</TD>
+
 	<TD ALIGN=LEFT VALIGN=TOP>
-	<B><A HREF="fluid.html#FLUID">9 - Programming with FLUID</A></B>
+
+ \subpage fluid
+ 	<B>
 	<UL>
 	<LI><A HREF="fluid.html#widget_attributes">Widget Attributes</A></LI>
 	<LI><A HREF="fluid.html#widget_attributes">Selecting Moving Widgets</A></LI>
 	<LI><A HREF="fluid.html#images">Image Labels</A></LI>
 	</UL>
-	<B>
+	</B>
+
  \subpage advanced
- 	</B>
-	<BR>
-	<BR>
+
 	<B><A HREF="classes.html">A - Class Reference</A></B>
-	<BR>
-	<BR>
+
 	<B><A HREF="globals_func.html">B - Function Reference</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="enumerations.html#Enumerations">C - FLTK Enumerations.H</A>
-	</B>
-	<BR>
-	<BR>
-	<B><A HREF="glut.html#glut">D - GLUT Compatibility</A></B>
+
+ \subpage enumerations
+
+ \subpage glut
+ 	<B>
 	<UL>
 	<LI><A HREF="glut.html#Fl_Glut_Window">class Fl_Glut_Window</A></LI>
 	</UL>
-	<B><A HREF="forms.html#forms">E - Forms Compatibility</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="osissues.html#osissues">F - Operating System Issues</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="migration.html">G - Migrating Code from FLTK 1.0.x</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="license.html#license">H - Software License</A></B>
-	<BR>
-	<BR>
-	<B><A HREF="examples.html#examples">I - Example Source Code</A></B>
-	</TD>
+	</B>
+
+ \subpage forms
+
+ \subpage osissues
+
+ \subpage migration_1_1
+
+ \subpage migration_1_3
+
+ \subpage license
+
+ \subpage examples
+
+</TD>
 </TR>
 </TABLE>
 
 */
-
-