fix overview links and various Doxygen errors (#9580)

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@54227 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/sizer.h

@@ -34,9 +34,9 @@
     OS X Human Interface Guidelines.
 
     @library{wxcore}
-    @category{FIXME}
+    @category{winlayout}
 
-    @see wxSizer, @ref overview_sizeroverview "Sizer overview",
+    @see wxSizer, @ref overview_sizer "Sizer Overview",
     wxDialog::CreateButtonSizer
 */
 class wxStdDialogButtonSizer : public wxBoxSizer
@@ -48,8 +48,8 @@ public:
     wxStdDialogButtonSizer();
 
     /**
-        Adds a button to the wxStdDialogButtonSizer. The button must have one of the
+        Adds a button to the wxStdDialogButtonSizer. The @a button must have 
-        following identifiers:
+        one of the following identifiers:
          wxID_OK
          wxID_YES
          wxID_SAVE
@@ -556,7 +556,7 @@ public:
     @library{wxcore}
     @category{winlayout}
 
-    @see wxSizer, @ref overview_sizeroverview "Sizer overview"
+    @see wxSizer, @ref overview_sizer "Sizer Overview"
 */
 class wxFlexGridSizer : public wxGridSizer
 {
@@ -625,7 +625,7 @@ public:
         Specifies whether the sizer should flexibly resize its columns, rows, or
         both. Argument @c direction can be @c wxVERTICAL, @c wxHORIZONTAL
         or @c wxBOTH (which is the default value). Any other value is ignored. See
-        @ref getflexibledrection() GetFlexibleDirection for the
+        @ref GetFlexibleDirection() GetFlexibleDirection for the
         explanation of these values.
         Note that this method does not trigger relayout.
     */
@@ -760,7 +760,7 @@ public:
     @library{wxcore}
     @category{winlayout}
 
-    @see @ref overview_sizeroverview "Sizer overview"
+    @see @ref overview_sizer "Sizer Overview"
 */
 class wxSizer : public wxObject
 {
@@ -1047,15 +1047,15 @@ public:
 
     /**
         Returns the list of the items in this sizer. The elements of type-safe
-        wxList @a wxSizerItemList are objects of type
+        wxList @a wxSizerItemList are pointers to objects of type
-        @ref overview_wxsizeritem "wxSizerItem *".
+        @ref wxSizerItem "wxSizerItem".
     */
     wxSizerItemList& GetChildren();
     
     /**
         Returns the list of the items in this sizer. The elements of type-safe
-        wxList @a wxSizerItemList are objects of type
+        wxList @a wxSizerItemList are pointers to objects of type
-        @ref overview_wxsizeritem "wxSizerItem *".
+        @ref wxSizerItem "wxSizerItem".
     */
     const wxSizerItemList& GetChildren() const;
 
@@ -1354,7 +1354,7 @@ public:
 
     /**
         Detaches the given @a oldwin from the sizer and
-        replaces it with the given @newwin. The detached
+        replaces it with the given @a newwin. The detached
         child window is @b not deleted (because windows are
         owned by their parent window, not the sizer).
         
@@ -1371,7 +1371,7 @@ public:
                  
     /**
         Detaches the given @a oldsz from the sizer and
-        replaces it with the given @newwin. The detached
+        replaces it with the given @a newsz. The detached
         child sizer is deleted. 
         
         Use parameter @a recursive to search the given element recursively in subsizers.
@@ -1387,7 +1387,7 @@ public:
                  
     /**
         Detaches the given item at position @a index from the sizer and
-        replaces it with the given wxSizerItem @ newitem.
+        replaces it with the given wxSizerItem @a newitem.
         
         The detached child is deleted @b only if it is a sizer or a spacer
         (but not if it is a wxWindow because windows are owned by their
@@ -1535,7 +1535,7 @@ public:
     @library{wxcore}
     @category{winlayout}
 
-    @see wxSizer, @ref overview_sizeroverview "Sizer overview"
+    @see wxSizer, @ref overview_sizer "Sizer Overview"
 */
 class wxGridSizer : public wxSizer
 {
@@ -1608,8 +1608,8 @@ public:
     @library{wxcore}
     @category{winlayout}
 
-    @see wxSizer, wxStaticBox, wxBoxSizer, @ref overview_sizeroverview "Sizer
+    @see wxSizer, wxStaticBox, wxBoxSizer, @ref overview_sizer 
-    overview"
+    "Sizer Overview"
 */
 class wxStaticBoxSizer : public wxBoxSizer
 {
@@ -1643,13 +1643,13 @@ public:
     simple basic geometry, typically in a row or a column or several hierarchies of
     either.
 
-    For more information, please see @ref overview_boxsizerprogramming "Programming
+    For more information, please see @ref overview_sizer_box 
-    with wxBoxSizer".
+    "Programming with wxBoxSizer".
 
     @library{wxcore}
     @category{winlayout}
 
-    @see wxSizer, @ref overview_sizeroverview "Sizer overview"
+    @see wxSizer, @ref overview_sizer "Sizers Overview"
 */
 class wxBoxSizer : public wxSizer
 {