Fix documentation errors and clarify label alignment docs.

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

FL/Enumerations.H

@@ -662,29 +662,37 @@ extern Fl_Labeltype FL_EXPORT fl_define_FL_EMBOSSED_LABEL();
 
 /** \name Alignment Flags 
     Flags to control the label alignment. 
+
     This controls how the label is displayed next to or inside the widget. 
-    The default value is FL_ALIGN_CENTER for most widgets, which centers the label
-    inside the widget.
+    The default value is FL_ALIGN_CENTER (0) for most widgets, which centers
+    the label inside the widget.
 
-    Flags can be or'd to achieve a combination of alignments.
+    Flags can be or'd to achieve a combination of alignments, but there
+    are some "magic values" (e.g. combinations of TOP and BOTTOM and of
+    LEFT and RIGHT) that have special meanings (see below). For instance:<BR>
+    FL_ALIGN_TOP_LEFT == (FL_ALIGN_TOP|FL_ALIGN_LEFT) != FL_ALIGN_LEFT_TOP.
 
     \code
-    Outside alignments:
+    Outside alignments (FL_ALIGN_INSIDE is not set):
+
                TOP_LEFT        TOP       TOP_RIGHT
-       LEFT_TOP+---------------------------------+RIGHT_TOP
+               +---------------------------------+
+       LEFT_TOP|                                 |RIGHT_TOP
                |                                 |
-           LEFT|                                 |RIGHT
+           LEFT|             CENTER              |RIGHT
                |                                 |
-    LEFT_BOTTOM+---------------------------------+RIGHT_BOTTOM
-               BOTTOM_RIGHT   BOTTOM   BOTTOM_LEFT
+    LEFT_BOTTOM|                                 |RIGHT_BOTTOM
+               +---------------------------------+
+               BOTTOM_LEFT   BOTTOM   BOTTOM_RIGHT
+
+    Inside alignments (FL_ALIGN_INSIDE is set):
 
-    Inside alignments:
                +---------------------------------+
                |TOP_LEFT       TOP      TOP_RIGHT|
                |                                 |
-               |LEFT                        RIGHT|
+               |LEFT         CENTER         RIGHT|
                |                                 |
-               |BOTTOM_RIGHT  BOTTOM  BOTTOM_LEFT|
+               |BOTTOM_LEFT  BOTTOM  BOTTOM_RIGHT|
                +---------------------------------+
     \endcode
     \see #FL_ALIGN_CENTER, etc.