fix miscellaneous doxygen warnings; IMPORTANT: never leave empty lines inside a @beginEventTable/@endEventTable block (or similar blocks); it results in difficult-to-fix doxygen warnings

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

interface/wx/grid.h

@@ -1068,7 +1068,7 @@ public:
     - wxGridCellFloatEditor
     - wxGridCellNumberEditor
     - wxGridCellTextEditor
-    
+
     Please see wxGridEvent, wxGridSizeEvent, wxGridRangeSelectEvent, and
     wxGridEditorCreatedEvent for the documentation of all event types you can
     use with wxGrid.
@@ -1665,7 +1665,7 @@ public:
         See wxGridTableBase::CanGetValueAs() and the @ref overview_grid for
         more information.
     */
-    const wxString GetCellValue(const wxGridCellCoords& coords) const;
+    const wxString& GetCellValue(const wxGridCellCoords& coords) const;
 
     /**
         Returns a pointer to the current default grid cell editor.
@@ -2332,12 +2332,12 @@ public:
         This method takes an array containing the indices of the columns in
         their display order, i.e. uses the same convention as
         wxHeaderCtrl::SetColumnsOrder().
-     */
+    */
     void SetColumnsOrder(const wxArrayInt& order);
 
     /**
         Resets the position of the columns to the default.
-     */
+    */
     void ResetColPos();
 
     //@}
@@ -2345,7 +2345,7 @@ public:
 
     /**
         @name Cursor Movement
-     */
+    */
     //@{
 
     /**
@@ -3354,8 +3354,8 @@ public:
     @event{EVT_GRID_CELL_CHANGING(func)}
         The user is about to change the data in a cell. The new cell value as
         string is available from GetString() event object method. This event
-        can be vetoed if the change is not allowed. Processes a @c
+        can be vetoed if the change is not allowed.
-        wxEVT_GRID_CELL_CHANGING event type.
+        Processes a @c wxEVT_GRID_CELL_CHANGING event type.
     @event{EVT_GRID_CELL_CHANGED(func)}
         The user changed the data in a cell. The old cell value as string is
         available from GetString() event object method. Notice that vetoing
@@ -3406,7 +3406,6 @@ public:
         proceed in which case wxGrid::SetColPos() is used to reorder the
         columns display order without affecting the use of the column indices
         otherwise.
-
         This event macro corresponds to @c wxEVT_GRID_COL_MOVE event type.
     @event{EVT_GRID_COL_SORT(func)}
         This event is generated when a column is clicked by the user and its
@@ -3417,7 +3416,6 @@ public:
         (and not vetoed) the grid supposes that the table was indeed resorted
         and updates the column to indicate the new sort order and refreshes
         itself.
-
         This event macro corresponds to @c wxEVT_GRID_COL_SORT event type.
     @endEventTable
 

interface/wx/scrolwin.h

@@ -287,7 +287,6 @@ public:
     */
     void GetScrollPixelsPerUnit(int* xUnit, int* yUnit) const;
 
-    //@{
     /**
         Get the position at which the visible portion of the window starts.
 
@@ -296,20 +295,24 @@ public:
         @param y
             Receives the first visible y position in scroll units.
 
-        @remarks If either of the scrollbars is not at the home position, x
+        @remarks
-                 and/or y will be greater than zero.  Combined with
+            If either of the scrollbars is not at the home position, @a x
-                 wxWindow::GetClientSize(), the application can use this
+            and/or @a y will be greater than zero.
-                 function to efficiently redraw only the visible portion
+            Combined with wxWindow::GetClientSize(), the application can use this
-                 of the window.  The positions are in logical scroll
+            function to efficiently redraw only the visible portion of the window.
-                 units, not pixels, so to convert to pixels you will
+            The positions are in logical scroll units, not pixels, so to convert
-                 have to multiply by the number of pixels per scroll
+            to pixels you will have to multiply by the number of pixels per scroll
-                 increment.
+            increment.
 
         @see SetScrollbars(), Scroll()
     */
     void GetViewStart(int* x, int* y) const;
+
+    /**
+        This is a simple overload of GetViewStart(int*,int*); see that function
+        for more info.
+    */
     wxPoint GetViewStart() const;
-    //@}
 
     /**
         Gets the size in device units of the scrollable window area (as
@@ -352,7 +355,6 @@ public:
     */
     void PrepareDC(wxDC& dc);
 
-    //@{
     /**
         Scrolls a window so the view start is at the given point.
 
@@ -364,14 +366,17 @@ public:
         @remarks The positions are in scroll units, not pixels, so to convert to
                  pixels you will have to multiply by the number of
                  pixels per scroll increment. If either parameter is
-                 wxDefaultCoord (-1), that position will be ignored (no change
+                 ::wxDefaultCoord (-1), that position will be ignored (no change
                  in that direction).
 
         @see SetScrollbars(), GetScrollPixelsPerUnit()
     */
     void Scroll(int x, int y);
+
+    /**
+        This is an overload of Scroll(int,int); see that function for more info.
+    */
     void Scroll(const wxPoint& pt);
-    //@}
 
     /**
         Set the horizontal and vertical scrolling increment only. See the

interface/wx/unichar.h

@@ -28,7 +28,7 @@ public:
     /**
         Default ctor.
     */
-    wxUniChar()
+    wxUniChar();
 
     //@{
     /**

interface/wx/window.h

@@ -1075,10 +1075,9 @@ public:
         (or toggle or ...) any items which should be disabled in the menu
         before showing it.
 
-        @param menu
+        The parameter @a menu is the menu to show.
-            The menu to show.
+        The parameter @a pos (or the parameters @a x and @a y) is the
-        @param pos
+        position at which to show the menu in client coordinates.
-            The position at which to show the menu in client coordinates.
 
         @return
              The selected menu item id or @c wxID_NONE if none selected or an