doxygen warnings and formatting fixes

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

docs/doxygen/mainpages/topics.h

@@ -79,6 +79,7 @@ The following is a basic categorization of them:
 
 @li @subpage overview_sizer
 @li @subpage overview_xrc
+@li @subpage overview_xrcformat
 @li @subpage overview_windowsizing
 @li @subpage overview_scrolling
 @li @subpage overview_dialog

docs/doxygen/overviews/scrolling.h

@@ -10,10 +10,7 @@
 
 @page overview_scrolling Scrolled Windows
 
-Classes:
-@li wxWindow
-@li ::wxScrolledWindow
-@li wxScrollBar
+Classes: wxWindow, wxScrolledWindow, wxScrollBar
 
 @li @ref overview_scrolling_model
 @li @ref overview_scrolling_example

docs/doxygen/overviews/xrc.h

@@ -43,7 +43,8 @@ XRC was written by Vaclav Slavik.
 @li @ref overview_xrc_sample
 @li @ref overview_xrc_cppheader
 @li @ref overview_xrc_newresourcehandlers
-@li @ref xrc_format
+
+See also the separate @ref overview_xrcformat page for details about the XRC file format.
 
 <hr>
 

interface/wx/socket.h

@@ -1196,6 +1196,8 @@ public:
 /**
     @class wxDatagramSocket
 
+    @todo docme
+
     @library{wxnet}
     @category{net}
 */
@@ -1205,8 +1207,10 @@ public:
     /**
         Constructor.
 
+        @param addr
+            The socket address.
         @param flags
-            Socket flags (See wxSocketBase::SetFlags())
+            Socket flags (See wxSocketBase::SetFlags()).
     */
     wxDatagramSocket(const wxSockAddress& addr,
                      wxSocketFlags flags = wxSOCKET_NONE);

interface/wx/string.h

@@ -320,14 +320,13 @@ public:
     @li Pad()
 
 
-    @section string_misc wxWidgets 1.xx compatibility functions
+    @section string_compat wxWidgets 1.xx compatibility functions
 
     The following functions are deprecated.
     Please consider using @c std::string compatible variants.
 
-    Contains(), First(), Freq(), IsAscii(), IsNull(),
-    IsNumber(), IsWord(), Last(), Length(), LowerCase(), Remove(), Strip(),
-    SubString(), UpperCase()
+    Contains(), First(), Freq(), IsAscii(), IsNull(), IsNumber(), IsWord(),
+    Last(), Length(), LowerCase(), Remove(), Strip(), SubString(), UpperCase()
 
 
     @library{wxbase}

interface/wx/textdlg.h

@@ -74,7 +74,7 @@ public:
             Message to show on the dialog.
         @param caption
             The caption of the the dialog.
-        @param defaultValue
+        @param value
             The default value, which may be the empty string.
         @param style
             A dialog style, specifying the buttons (wxOK, wxCANCEL)

interface/wx/xrc/xmlres.h

@@ -31,7 +31,7 @@ enum wxXmlResourceFlags
     The class holds XML resources from one or more .xml files, binary files or zip
     archive files.
 
-    @see @ref overview_xrc, @ref xrc_format
+    @see @ref overview_xrc, @ref overview_xrcformat
 
     @library{wxxrc}
     @category{xrc}