Fix all the other comments with Doxygen grouping commands too

This is the same thing as bd92523bc5 (Fix use of Doxygen @addtogroup
command, 2022-08-03) except it fixes comments format for all the other
occurrences of "@{" and "@}" too, not just for those used with
@addtogroup which was the problem in #22572.

This fixes many different formatting problems due to attaching various
Doxygen commands to wrong elements because of broken grouping, e.g. all
overloaded functions were documented incorrectly and there were several
problems in wxString documentation.

See #22248.

interface/wx/affinematrix2d.h

@@ -81,7 +81,7 @@ public:
     */
     bool IsIdentity() const;
 
-    //@{
+    ///@{
     /**
         Check that this matrix is identical with @a t.
 
@@ -90,7 +90,7 @@ public:
     */
     void IsEqual(const wxAffineMatrix2DBase& t);
     bool operator==(const wxAffineMatrix2DBase& t) const;
-    //@}
+    ///@}
 
     /**
         Check that this matrix differs from @a t.

interface/wx/affinematrix2dbase.h

@@ -114,7 +114,7 @@ public:
     */
     virtual bool IsIdentity() const = 0;
 
-    //@{
+    ///@{
     /**
         Check that this matrix is identical with @a t.
 
@@ -123,7 +123,7 @@ public:
     */
     virtual bool IsEqual(const wxAffineMatrix2DBase& t) const = 0;
     bool operator==(const wxAffineMatrix2DBase& t) const;
-    //@}
+    ///@}
 
     /**
         Check that this matrix differs from @a t.

interface/wx/any.h

@@ -178,7 +178,7 @@ public:
     */
     void MakeNull();
 
-    //@{
+    ///@{
     /**
         @name Assignment operators
     */
@@ -186,9 +186,9 @@ public:
     wxAny& operator=(const T &value);
     wxAny& operator=(const wxAny &any);
     wxAny& operator=(const wxVariant &variant);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         @name Equality operators
 
@@ -220,9 +220,9 @@ public:
     bool operator==(const char* value) const;
     bool operator==(const wchar_t* value) const;
     bool operator==(const wxString& value) const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         @name Inequality operators
     */
@@ -242,7 +242,7 @@ public:
     bool operator!=(const char* value) const;
     bool operator!=(const wchar_t* value) const;
     bool operator!=(const wxString& value) const;
-    //@}
+    ///@}
 };
 
 

interface/wx/anybutton.h

@@ -204,10 +204,10 @@ public:
 
         @since 2.9.1
      */
-    //@{
+    ///@{
     void SetBitmapMargins(wxCoord x, wxCoord y);
     void SetBitmapMargins(const wxSize& sz);
-    //@}
+    ///@}
 
     /**
         Set the position at which the bitmap is displayed.

interface/wx/app.h

@@ -61,7 +61,7 @@ public:
         Note that you should look at wxEvtLoopBase for more event-processing
         documentation.
     */
-    //@{
+    ///@{
 
     /**
         Called by wxWidgets on creation of the application. Override this if you wish
@@ -126,7 +126,7 @@ public:
      */
     virtual bool UsesEventLoop() const;
 
-    //@}
+    ///@}
 
 
     /**
@@ -136,7 +136,7 @@ public:
         to allow queuing of events even when there's no event loop
         (e.g. in wxAppConsole::OnInit).
     */
-    //@{
+    ///@{
 
     /**
         Process all pending events; it is necessary to call this function to
@@ -185,7 +185,7 @@ public:
     */
     void ResumeProcessingOfPendingEvents();
 
-    //@}
+    ///@}
 
     /**
         Delayed objects destruction.
@@ -195,7 +195,7 @@ public:
         still pending for the same object. In this case the handler may call
         ScheduleForDestruction() instead.
      */
-    //@{
+    ///@{
 
     /**
         Schedule the object for destruction in the near future.
@@ -219,7 +219,7 @@ public:
      */
     bool IsScheduledForDestruction(wxObject *object) const;
 
-    //@}
+    ///@}
 
 
     /**
@@ -268,7 +268,7 @@ public:
     /**
         @name Callbacks for application-wide "events"
     */
-    //@{
+    ///@{
 
     /**
         This function is called when an assert failure occurs, i.e.\ the condition
@@ -422,7 +422,7 @@ public:
     */
     virtual int OnRun();
 
-    //@}
+    ///@}
 
 
     /**
@@ -432,7 +432,7 @@ public:
 
         @see overview_exceptions
     */
-    //@{
+    ///@{
 
     /**
         This function is called if an unhandled exception occurs inside the main
@@ -614,13 +614,13 @@ public:
     */
     virtual void RethrowStoredException();
 
-    //@}
+    ///@}
 
 
     /**
         @name Application information
     */
-    //@{
+    ///@{
 
     /**
         Returns the user-readable application name.
@@ -732,7 +732,7 @@ public:
     */
     void SetVendorName(const wxString& name);
 
-    //@}
+    ///@}
 
     /**
         Sets the C locale to the default locale for the current environment.
@@ -1034,7 +1034,7 @@ public:
     /**
         @name GTK-specific functions
     */
-    //@{
+    ///@{
 
     /**
         Disables the printing of various GTK messages.
@@ -1061,12 +1061,12 @@ public:
     */
     static void GTKSuppressDiagnostics(int flags = -1);
 
-    //@}
+    ///@}
 
     /**
         @name Mac-specific functions
     */
-    //@{
+    ///@{
 
     /**
         Called in response of an "open-application" Apple event.
@@ -1160,7 +1160,7 @@ public:
     */
     void OSXEnableAutomaticTabbing(bool enable);
 
-    //@}
+    ///@}
 
 };
 

interface/wx/archive.h

@@ -363,7 +363,7 @@ public:
     */
     void SetConv(wxMBConv& conv);
 
-    //@{
+    ///@{
     /**
         GetFirst and GetNext can be used to enumerate the available factories.
         For example, to list them:
@@ -383,7 +383,7 @@ public:
     */
     static const wxArchiveClassFactory* GetFirst();
     const wxArchiveClassFactory* GetNext() const;
-    //@}
+    ///@}
 
     /**
         Calls the static GetInternalName() function for the archive entry type,
@@ -420,7 +420,7 @@ public:
     */
     wxArchiveEntry* NewEntry() const;
 
-    //@{
+    ///@{
     /**
         Create a new input or output stream to read or write an archive.
 
@@ -431,7 +431,7 @@ public:
     wxArchiveOutputStream* NewStream(wxOutputStream& stream) const;
     wxArchiveInputStream* NewStream(wxInputStream* stream) const;
     wxArchiveOutputStream* NewStream(wxOutputStream* stream) const;
-    //@}
+    ///@}
 
     /**
         Adds this class factory to the list returned by GetFirst() or GetNext().
@@ -610,12 +610,12 @@ public:
     */
     const T operator*() const;
 
-    //@{
+    ///@{
     /**
         Position the input iterator at the next entry in the archive input stream.
     */
     wxArchiveIterator operator++();
     wxArchiveIterator operator++(int);
-    //@}
+    ///@}
 };
 

interface/wx/arrstr.h

@@ -76,13 +76,13 @@ public:
     */
     wxArrayString(const wxArrayString& array);
 
-    //@{
+    ///@{
     /**
         Constructor from a C string array. Pass a size @a sz and an array @a arr.
     **/
     wxArrayString(size_t sz, const char** arr);
     wxArrayString(size_t sz, const wchar_t** arr);
-    //@}
+    ///@}
 
     /**
         Constructor from a wxString array. Pass a size @a sz and array @a arr.
@@ -167,20 +167,20 @@ public:
 
         @see operator[] for the operator version.
     */
-    //@{
+    ///@{
     wxString& Item(size_t nIndex);
     const wxString& Item(size_t nIndex) const;
-    //@}
+    ///@}
 
     /**
         Returns the last element of the array. Attempt to access the last element of
         an empty array will result in assert failure in debug build, however no checks
         are done in release mode.
     */
-    //@{
+    ///@{
     wxString& Last();
     const wxString& Last() const;
-    //@}
+    ///@}
 
     /**
         Removes the first item matching this value. An assert failure is provoked by
@@ -343,7 +343,7 @@ public:
     void Insert(const wxString& str, size_t nIndex,
                 size_t copies = 1);
 
-    //@{
+    ///@{
     /**
         @warning This function should not be used with sorted array because it could
                  break the order of items and, for example, subsequent calls to Index()
@@ -354,7 +354,7 @@ public:
     */
     void Sort(bool reverseOrder = false);
     void Sort(CompareFunction compareFunction);
-    //@}
+    ///@}
 };
 
 /**

interface/wx/bookctrl.h

@@ -106,7 +106,7 @@ public:
         Each page may have an attached image.
         The functions of this group manipulate that image.
     */
-    //@{
+    ///@{
 
 
     /**
@@ -120,7 +120,7 @@ public:
     */
     virtual bool SetPageImage(size_t page, int image) = 0;
 
-    //@}
+    ///@}
 
 
 
@@ -130,7 +130,7 @@ public:
         Each page has a text string attached.
         The functions of this group manipulate that text.
     */
-    //@{
+    ///@{
 
     /**
         Returns the string for the given page.
@@ -141,7 +141,7 @@ public:
         Sets the text for the given page.
     */
     virtual bool SetPageText(size_t page, const wxString& text) = 0;
-    //@}
+    ///@}
 
 
 
@@ -150,7 +150,7 @@ public:
 
         The functions of this group manipulate the selection.
     */
-    //@{
+    ///@{
 
     /**
         Returns the currently selected page, or @c wxNOT_FOUND if none was selected.
@@ -205,7 +205,7 @@ public:
     */
     int FindPage(const wxWindow* page) const;
 
-    //@}
+    ///@}
 
 
 
@@ -241,7 +241,7 @@ public:
 
         Functions for adding/removing pages from this control.
     */
-    //@{
+    ///@{
 
     /**
         Adds a new page.
@@ -333,7 +333,7 @@ public:
     */
     wxWindow* GetPage(size_t page) const;
 
-    //@}
+    ///@}
 
 
 /*

interface/wx/brush.h

@@ -215,7 +215,7 @@ public:
     bool IsTransparent() const;
 
 
-    //@{
+    ///@{
     /**
         Sets the brush colour using red, green and blue values.
 
@@ -223,7 +223,7 @@ public:
     */
     virtual void SetColour(const wxColour& colour);
     virtual void SetColour(unsigned char red, unsigned char green, unsigned char blue);
-    //@}
+    ///@}
 
     /**
         Sets the stipple bitmap.

interface/wx/calctrl.h

@@ -523,7 +523,7 @@ public:
     /**
         @name Date Range Functions
      */
-    //@{
+    ///@{
 
     /**
         Restrict the dates that can be selected in the control to the specified
@@ -566,6 +566,6 @@ public:
     virtual bool GetDateRange(wxDateTime *lowerdate,
                                 wxDateTime *upperdate) const;
 
-    //@}
+    ///@}
 };
 

interface/wx/caret.h

@@ -31,23 +31,23 @@ public:
     */
     wxCaret();
 
-    //@{
+    ///@{
     /**
         Creates a caret with the given size (in pixels) and associates it with
         the @a window.
     */
     wxCaret(wxWindow* window, int width, int height);
     wxCaret(wxWindow* window, const wxSize& size);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Creates a caret with the given size (in pixels) and associates it with
         the @a window (same as the equivalent constructors).
     */
     bool Create(wxWindow* window, int width, int height);
     bool Create(wxWindow* window, const wxSize& size);
-    //@}
+    ///@}
 
     /**
         Returns the blink time which is measured in milliseconds and is the
@@ -56,7 +56,7 @@ public:
     */
     static int GetBlinkTime();
 
-    //@{
+    ///@{
     /**
         Get the caret position (in pixels).
 
@@ -69,9 +69,9 @@ public:
     */
     void GetPosition(int* x, int* y) const;
     wxPoint GetPosition() const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Get the caret size.
 
@@ -84,7 +84,7 @@ public:
     */
     void GetSize(int* width, int* height) const;
     wxSize GetSize() const;
-    //@}
+    ///@}
 
     /**
         Get the window the caret is associated with.
@@ -108,13 +108,13 @@ public:
     */
     bool IsVisible() const;
 
-    //@{
+    ///@{
     /**
         Move the caret to given position (in logical coordinates).
     */
     void Move(int x, int y);
     void Move(const wxPoint& pt);
-    //@}
+    ///@}
 
     /**
         Sets the blink time for all the carets.
@@ -127,13 +127,13 @@ public:
     */
     static void SetBlinkTime(int milliseconds);
 
-    //@{
+    ///@{
     /**
         Changes the size of the caret.
     */
     void SetSize(int width, int height);
     void SetSize(const wxSize& size);
-    //@}
+    ///@}
 
     /**
         Shows or hides the caret. Notice that if the caret was hidden N times,

interface/wx/checklst.h

@@ -37,7 +37,7 @@ public:
     */
     wxCheckListBox();
 
-    //@{
+    ///@{
     /**
         Constructor, creating and showing a list box.
 
@@ -106,7 +106,7 @@ public:
                    long style = 0,
                    const wxValidator& validator = wxDefaultValidator,
                    const wxString& name = "listBox");
-    //@}
+    ///@}
 
     bool Create(wxWindow *parent,
                 wxWindowID id,

interface/wx/choicdlg.h

@@ -44,7 +44,7 @@
 class wxMultiChoiceDialog : public wxDialog
 {
 public:
-    //@{
+    ///@{
     /**
         Constructor taking an array of wxString choices.
 
@@ -108,7 +108,7 @@ public:
                         const wxArrayString& choices,
                         long style = wxCHOICEDLG_STYLE,
                         const wxPoint& pos = wxDefaultPosition);
-    //@}
+    ///@}
 
     /**
         Returns array with indexes of selected items.
@@ -152,7 +152,7 @@ public:
 class wxSingleChoiceDialog : public wxDialog
 {
 public:
-    //@{
+    ///@{
     /**
         Constructor, taking an array of wxString choices and optional client
         data.
@@ -226,7 +226,7 @@ public:
                          void** clientData = NULL,
                          long style = wxCHOICEDLG_STYLE,
                          const wxPoint& pos = wxDefaultPosition);
-    //@}
+    ///@}
 
     /**
         Returns the index of selected item.

interface/wx/choice.h

@@ -118,7 +118,7 @@ public:
     */
     virtual ~wxChoice();
 
-    //@{
+    ///@{
     /**
         Creates the choice for two-step construction. See wxChoice().
     */
@@ -136,7 +136,7 @@ public:
             long style = 0,
             const wxValidator& validator = wxDefaultValidator,
             const wxString& name = wxChoiceNameStr );
-    //@}
+    ///@}
 
     /**
         Gets the number of columns in this choice item.

interface/wx/choicebk.h

@@ -65,7 +65,7 @@ wxEventType wxEVT_CHOICEBOOK_PAGE_CHANGING;
 class wxChoicebook : public wxBookCtrlBase
 {
 public:
-    //@{
+    ///@{
     /**
         Constructs a choicebook control.
     */
@@ -75,7 +75,7 @@ public:
                  const wxSize& size = wxDefaultSize,
                  long style = 0,
                  const wxString& name = wxEmptyString);
-    //@}
+    ///@}
 
     /**
        Create the choicebook control that has already been constructed with

interface/wx/clrpicker.h

@@ -120,13 +120,13 @@ public:
     */
     wxColour GetColour() const;
 
-    //@{
+    ///@{
     /**
         Sets the currently selected colour. See wxColour::Set().
     */
     void SetColour(const wxColour& col);
     void SetColour(const wxString& colname);
-    //@}
+    ///@}
 };
 
 

interface/wx/cmdline.h

@@ -688,7 +688,7 @@ public:
     */
     int Parse(bool giveUsage = true);
 
-    //@{
+    ///@{
     /**
         Set the command line to parse after using one of the constructors which
         don't do it.
@@ -696,7 +696,7 @@ public:
     void SetCmdLine(int argc, char** argv);
     void SetCmdLine(int argc, wchar_t** argv);
     void SetCmdLine(const wxString& cmdline);
-    //@}
+    ///@}
 
     /**
         Constructs the command line description.

interface/wx/colour.h

@@ -172,7 +172,7 @@ public:
     */
     virtual wxString GetAsString(long flags = wxC2S_NAME | wxC2S_CSS_SYNTAX) const;
 
-    //@{
+    ///@{
     /**
         Sets the RGB or RGBA colour values from a single 32 bit value.
 
@@ -188,9 +188,9 @@ public:
     */
     void SetRGB(wxUint32 colRGB);
     void SetRGBA(wxUint32 colRGBA);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Gets the RGB or RGBA colour values as a single 32 bit value.
 
@@ -206,7 +206,7 @@ public:
     */
     wxUint32 GetRGB() const;
     wxUint32 GetRGBA() const;
-    //@}
+    ///@}
 
     /**
         Return the perceived brightness of the colour.
@@ -256,7 +256,7 @@ public:
         @since 3.1.2
     */
     virtual bool IsSolid() const;
-    //@{
+    ///@{
     /**
         Sets the RGB intensity values using the given values (first overload),
         extracting them from the packed long (second overload), using the given
@@ -276,7 +276,7 @@ public:
              unsigned char alpha = wxALPHA_OPAQUE);
     void Set(unsigned long RGB);
     bool Set(const wxString& str);
-    //@}
+    ///@}
 
     /**
         Tests the inequality of two colours by comparing individual red, green, blue

interface/wx/combo.h

@@ -792,7 +792,7 @@ public:
     */
     void SetMainControl(wxWindow* win);
 
-    //@{
+    ///@{
     /**
         Attempts to set the control margins. When margins are given as wxPoint,
         x indicates the left and y the top margin. Use -1 to indicate that
@@ -805,7 +805,7 @@ public:
     */
     bool SetMargins(const wxPoint& pt);
     bool SetMargins(wxCoord left, wxCoord top = -1);
-    //@}
+    ///@}
 
     /**
         Set side of the control to which the popup will align itself. Valid

interface/wx/combobox.h

@@ -175,7 +175,7 @@ public:
     */
     virtual ~wxComboBox();
 
-    //@{
+    ///@{
     /**
         Creates the combobox for two-step construction. Derived classes should
         call or replace this function. See wxComboBox() for further details.
@@ -196,7 +196,7 @@ public:
                 long style = 0,
                 const wxValidator& validator = wxDefaultValidator,
                 const wxString& name = wxComboBoxNameStr);
-    //@}
+    ///@}
 
     /**
         Returns the item being selected right now.

interface/wx/config.h

@@ -342,7 +342,7 @@ public:
 
         See @ref configbase_paths
     */
-    //@{
+    ///@{
 
     /**
         Retrieve the current path (always as absolute path).
@@ -358,7 +358,7 @@ public:
     */
     virtual void SetPath(const wxString& strPath) = 0;
 
-    //@}
+    ///@}
 
 
     /**
@@ -366,7 +366,7 @@ public:
 
         See @ref configbase_enumeration
     */
-    //@{
+    ///@{
 
     /**
         Gets the first entry.
@@ -421,7 +421,7 @@ public:
     */
     virtual size_t GetNumberOfGroups(bool bRecursive = false) const = 0;
 
-    //@}
+    ///@}
 
 
     enum EntryType
@@ -436,7 +436,7 @@ public:
     /**
         @name Tests of Existence
     */
-    //@{
+    ///@{
 
     /**
         @return @true if either a group or an entry with a given name exists.
@@ -462,13 +462,13 @@ public:
     */
     virtual bool HasGroup(const wxString& strName) const = 0;
 
-    //@}
+    ///@}
 
 
     /**
         @name Miscellaneous Functions
     */
-    //@{
+    ///@{
 
     /**
         Returns the application name.
@@ -480,7 +480,7 @@ public:
     */
     wxString GetVendorName() const;
 
-    //@}
+    ///@}
 
 
     /**
@@ -488,7 +488,7 @@ public:
 
         See @ref configbase_keyaccess
     */
-    //@{
+    ///@{
 
     /**
         Permanently writes all changes (otherwise, they're only written from
@@ -767,7 +767,7 @@ public:
     */
     bool Write(const wxString& key, T const& buf);
 
-    //@}
+    ///@}
 
 
     /**
@@ -779,7 +779,7 @@ public:
         entry/group with the new name already exists or because the function is
         not supported in this wxConfig implementation.
     */
-    //@{
+    ///@{
 
     /**
         Renames an entry in the current group. The entries names (both the old
@@ -803,7 +803,7 @@ public:
     virtual bool RenameGroup(const wxString& oldName,
                              const wxString& newName) = 0;
 
-    //@}
+    ///@}
 
 
     /**
@@ -813,7 +813,7 @@ public:
         file. DeleteAll() is especially useful if you want to erase all traces
         of your program presence: for example, when you uninstall it.
     */
-    //@{
+    ///@{
 
     /**
         Delete the whole underlying object (disk file, registry key, ...).
@@ -836,7 +836,7 @@ public:
     */
     virtual bool DeleteGroup(const wxString& key) = 0;
 
-    //@}
+    ///@}
 
 
     /**
@@ -866,7 +866,7 @@ public:
         SetExpandEnvVars(@true) just after. Another solution would be to prefix
         the offending symbols with a backslash.
     */
-    //@{
+    ///@{
 
     /**
         Returns @true if we are expanding environment variables in key values.
@@ -895,7 +895,7 @@ public:
     */
     void SetRecordDefaults(bool bDoIt = true);
 
-    //@}
+    ///@}
 
 
     /**

interface/wx/ctrlsub.h

@@ -32,7 +32,7 @@ public:
     /// Constructor
     wxItemContainerImmutable();
 
-    //@{
+    ///@{
 
     /**
         Returns the number of items in the control.
@@ -90,10 +90,10 @@ public:
     */
     virtual int FindString(const wxString& string, bool caseSensitive = false) const;
 
-    //@}
+    ///@}
 
     /// @name Selection
-    //@{
+    ///@{
 
     /**
         Sets the selection to the given item @a n or removes the selection
@@ -151,7 +151,7 @@ public:
     */
     void Select(int n);
 
-    //@}
+    ///@}
 };
 
 
@@ -196,7 +196,7 @@ public:
 class wxItemContainer : public wxItemContainerImmutable
 {
 public:
-    //@{
+    ///@{
 
     /**
         Appends item into the control.
@@ -336,7 +336,7 @@ public:
     */
     int Append(unsigned int n, const wxString* items,
                 wxClientData** clientData);
-    //@}
+    ///@}
 
     /**
         Removes all items from the control.
@@ -411,7 +411,7 @@ public:
     bool HasClientUntypedData() const;
 
 
-    //@{
+    ///@{
 
     /**
         Returns a pointer to the client data associated with the given item (if
@@ -472,9 +472,9 @@ public:
     */
     void SetClientObject(unsigned int n, wxClientData* data);
 
-    //@}
+    ///@}
 
-    //@{
+    ///@{
 
     /**
         Inserts item into the control.
@@ -644,9 +644,9 @@ public:
     int Insert(unsigned int n, const wxString* items,
                 unsigned int pos,
                 wxClientData** clientData);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Replaces the current control contents with the given items.
 
@@ -740,7 +740,7 @@ public:
             new items.
     */
     void Set(unsigned int n, const wxString* items, wxClientData** clientData);
-    //@}
+    ///@}
 };
 
 

interface/wx/datetime.h

@@ -94,7 +94,7 @@ public:
         /// the time in the current time zone
         Local,
 
-        //@{
+        ///@{
         /// zones from GMT (= Greenwich Mean Time): they're guaranteed to be
         /// consequent numbers, so writing something like `GMT0 + offset' is
         /// safe if abs(offset) <= 12
@@ -107,7 +107,7 @@ public:
         GMT7, GMT8, GMT9, GMT10, GMT11, GMT12, GMT13,
         // Note that GMT12 and GMT_12 are not the same: there is a difference
         // of exactly one day between them
-        //@}
+        ///@}
 
         // some symbolic names for TZ
 
@@ -312,7 +312,7 @@ public:
         you should use IsValid() method to check that the values were correct
         as constructors cannot return an error code.
     */
-    //@{
+    ///@{
 
     /**
         Default constructor. Use one of the Set() functions to initialize the
@@ -479,7 +479,7 @@ public:
     */
     wxDateTime& operator=(const struct tm& tm);
 
-    //@}
+    ///@}
 
 
 
@@ -490,7 +490,7 @@ public:
         perform some more complicated calculations to find the answer are under
         the "Date Arithmetic" section.
     */
-    //@{
+    ///@{
 
     /**
         Returns the date and time in DOS format.
@@ -665,7 +665,7 @@ public:
     */
     bool IsWorkDay(Country country = Country_Default) const;
 
-    //@}
+    ///@}
 
 
 
@@ -682,7 +682,7 @@ public:
         using any other operators or IsEarlierThan() or IsLaterThan() functions
         would result in an assert because their result is not well-defined.
     */
-    //@{
+    ///@{
 
     /**
         Returns @true if this date precedes the given one.
@@ -732,7 +732,7 @@ public:
     */
     bool IsBetween(const wxDateTime& t1, const wxDateTime& t2) const;
 
-    //@}
+    ///@}
 
 
 
@@ -751,7 +751,7 @@ public:
         the object to which it is applied. The operators "-=" and "+=" are
         defined to be equivalent to the second forms of these functions.
     */
-    //@{
+    ///@{
 
     /**
         Adds the given date span to this object.
@@ -839,7 +839,7 @@ public:
     */
     wxTimeSpan operator-(const wxDateTime& dt2) const;
 
-    //@}
+    ///@}
 
 
 
@@ -848,7 +848,7 @@ public:
 
         See @ref datetime_formatting
     */
-    //@{
+    ///@{
 
     /**
         This function does the same as the standard ANSI C @c strftime(3)
@@ -1060,7 +1060,7 @@ public:
     */
     bool ParseTime(const wxString& time, wxString::const_iterator *end);
 
-    //@}
+    ///@}
 
 
 
@@ -1075,7 +1075,7 @@ public:
         None of the functions in this section modify the time part of the
         wxDateTime, they only work with the date part of it.
     */
-    //@{
+    ///@{
 
     /**
         Returns the copy of this object to which SetToLastMonthDay() was
@@ -1194,7 +1194,7 @@ public:
     */
     wxDateTime& SetToYearDay(wxDateTime_t yday);
 
-    //@}
+    ///@}
 
 
 
@@ -1207,7 +1207,7 @@ public:
 
         Related functions in other groups: wxDateTime(double), Set(double)
     */
-    //@{
+    ///@{
 
     /**
         Synonym for GetJulianDayNumber().
@@ -1244,7 +1244,7 @@ public:
     */
     double GetRataDie() const;
 
-    //@}
+    ///@}
 
 
 
@@ -1261,7 +1261,7 @@ public:
 
         Related functions in other groups: GetBeginDST(), GetEndDST()
     */
-    //@{
+    ///@{
 
     /**
         Transform the date from the given time zone to the local one.
@@ -1317,7 +1317,7 @@ public:
     */
     wxDateTime ToUTC(bool noDST = false) const;
 
-    //@}
+    ///@}
 
 
 

interface/wx/dcbuffer.h

@@ -107,7 +107,7 @@ public:
     */
     virtual ~wxBufferedDC();
 
-    //@{
+    ///@{
     /**
         Initializes the object created using the default constructor. Please
         see the constructors for parameter details.
@@ -116,7 +116,7 @@ public:
               int style = wxBUFFER_CLIENT_AREA);
     void Init(wxDC* dc, wxBitmap& buffer = wxNullBitmap,
               int style = wxBUFFER_CLIENT_AREA);
-    //@}
+    ///@}
 
 
     /**
@@ -203,7 +203,7 @@ wxDC* wxAutoBufferedPaintDCFactory(wxWindow* window);
 class wxBufferedPaintDC : public wxBufferedDC
 {
 public:
-    //@{
+    ///@{
     /**
         As with wxBufferedDC, you may either provide the bitmap to be used for
         buffering or let this object create one internally (in the latter case,
@@ -218,7 +218,7 @@ public:
                       int style = wxBUFFER_CLIENT_AREA);
     wxBufferedPaintDC(wxWindow* window,
                       int style = wxBUFFER_CLIENT_AREA);
-    //@}
+    ///@}
 
     /**
         Copies everything drawn on the DC so far to the window associated with

interface/wx/dcsvg.h

@@ -110,7 +110,7 @@ public:
     */
     void DestroyClippingRegion();
 
-    //@{
+    ///@{
     /**
         Function not implemented in this DC class.
     */
@@ -126,7 +126,7 @@ public:
     void EndDoc();
     void StartPage();
     void EndPage();
-    //@}
+    ///@}
 };
 
 /**

interface/wx/dde.h

@@ -61,7 +61,7 @@ public:
     */
     wxDDEConnection(void* buffer, size_t size);
 
-    //@{
+    ///@{
     /**
         Called by the server application to advise the client of a change in
         the data associated with the given item. Causes the client connection's
@@ -74,7 +74,7 @@ public:
     bool Advise(const wxString& item, const char* data);
     bool Advise(const wxString& item, const wchar_t* data);
     bool Advise(const wxString& item, const wxString data);
-    //@}
+    ///@}
 
     /**
         Called by the client or server application to disconnect from the other
@@ -88,7 +88,7 @@ public:
     */
     bool Disconnect();
 
-    //@{
+    ///@{
     /**
         Called by the client application to execute a command on the server.
         Can also be used to transfer arbitrary data to the server (similar to
@@ -102,7 +102,7 @@ public:
     bool Execute(const char* data);
     bool Execute(const wchar_t* data);
     bool Execute(const wxString data);
-    //@}
+    ///@}
 
     /**
         Message sent to the client application when the server notifies it of a
@@ -157,7 +157,7 @@ public:
     */
     virtual bool OnStopAdvise(const wxString& topic, const wxString& item);
 
-    //@{
+    ///@{
     /**
         Called by the client application to poke data into the server. Can be
         used to transfer arbitrary data to the server. Causes the server
@@ -170,7 +170,7 @@ public:
     bool Poke(const wxString& item, const char* data);
     bool Poke(const wxString& item, const wchar_t* data);
     bool Poke(const wxString& item, const wxString data);
-    //@}
+    ///@}
 
     /**
         Called by the client application to request data from the server.

interface/wx/docmdi.h

@@ -23,7 +23,7 @@
 class wxDocMDIParentFrame : public wxMDIParentFrame
 {
 public:
-    //@{
+    ///@{
     /**
         Constructor.
     */
@@ -35,7 +35,7 @@ public:
                         const wxSize& size = wxDefaultSize,
                         long style = wxDEFAULT_FRAME_STYLE,
                         const wxString& name = wxFrameNameStr);
-    //@}
+    ///@}
 
     /**
         Destructor.

interface/wx/docview.h

@@ -200,10 +200,10 @@ public:
         Returns a reference to the wxPageSetupDialogData associated with the
         printing operations of this document manager.
     */
-    //@{
+    ///@{
     wxPageSetupDialogData& GetPageSetupDialogData();
     const wxPageSetupDialogData& GetPageSetupDialogData() const;
-    //@}
+    ///@}
 
     /**
         Returns the run-time class information that allows view instances
@@ -1399,7 +1399,7 @@ public:
     */
     wxViewVector GetViewsVector() const;
 
-    //@{
+    ///@{
     /**
         Returns the list whose elements are the views on the document.
 
@@ -1407,7 +1407,7 @@ public:
     */
     wxList& GetViews();
     const wxList& GetViews() const;
-    //@}
+    ///@}
 
     /**
         Returns true if this document is a child document corresponding to a
@@ -1430,7 +1430,7 @@ public:
     */
     virtual bool IsModified() const;
 
-    //@{
+    ///@{
     /**
         Override this function and call it from your own LoadObject() before
         streaming your own data. LoadObject() is called by the framework
@@ -1441,7 +1441,7 @@ public:
     */
     virtual istream& LoadObject(istream& stream);
     virtual wxInputStream& LoadObject(wxInputStream& stream);
-    //@}
+    ///@}
 
     /**
         Call with @true to mark the document as modified since the last save,
@@ -1572,7 +1572,7 @@ public:
     */
     virtual bool Revert();
 
-    //@{
+    ///@{
     /**
         Override this function and call it from your own SaveObject() before
         streaming your own data. SaveObject() is called by the framework
@@ -1583,7 +1583,7 @@ public:
     */
     virtual ostream& SaveObject(ostream& stream);
     virtual wxOutputStream& SaveObject(wxOutputStream& stream);
-    //@}
+    ///@}
 
     /**
         Sets the command processor to be used for this document. The document

interface/wx/dynarray.h

@@ -232,7 +232,7 @@ public:
         use wxBaseArray anyhow it shouldn't be a problem) and that you should
         not derive your own classes from the array classes.
     */
-    //@{
+    ///@{
 
     /**
         Default constructor.
@@ -305,7 +305,7 @@ public:
     */
     ~wxObjArray();
 
-    //@}
+    ///@}
 
 
     /**
@@ -324,7 +324,7 @@ public:
         put in the array and will prevent the array code from reallocating the
         memory more times than needed.
     */
-    //@{
+    ///@{
 
     /**
         Preallocates memory for a given number of array elements. It is worth
@@ -344,7 +344,7 @@ public:
     */
     void Shrink();
 
-    //@}
+    ///@}
 
 
     /**
@@ -354,7 +354,7 @@ public:
         allow to retrieve them - possibly using just the C array indexing []
         operator which does exactly the same as the Item() method.
     */
-    //@{
+    ///@{
 
     /**
         Return the number of items in the array.
@@ -386,13 +386,13 @@ public:
     */
     T& Last() const;
 
-    //@}
+    ///@}
 
 
     /**
         @name Adding Items
     */
-    //@{
+    ///@{
 
     /**
         Appends the given number of @a copies of the @a item to the array
@@ -507,13 +507,13 @@ public:
     */
     void SetCount(size_t count, T defval = T(0));
 
-    //@}
+    ///@}
 
 
     /**
         @name Removing Items
     */
-    //@{
+    ///@{
 
     /**
         This function does the same as Empty() and additionally frees the
@@ -580,13 +580,13 @@ public:
     */
     void RemoveAt(size_t index, size_t count = 1);
 
-    //@}
+    ///@}
 
 
     /**
         @name Searching and Sorting
     */
-    //@{
+    ///@{
 
     /**
         This version of Index() is for wxArray and wxObjArray only.
@@ -648,7 +648,7 @@ public:
     */
     void Sort(CMPFUNC<T> compareFunction);
 
-    //@}
+    ///@}
 };
 
 

interface/wx/encconv.h

@@ -94,7 +94,7 @@ public:
         See the Convert(const char*,char*) const overload for more info.
     */
     wxString Convert(const wxString& input) const;
-    //@}
+    ///@}
 
 
     /**

interface/wx/event.h

@@ -398,7 +398,7 @@ public:
     /**
         @name Event queuing and processing
     */
-    //@{
+    ///@{
 
     /**
         Queue event for a later processing.
@@ -695,13 +695,13 @@ public:
     */
     void DeletePendingEvents();
 
-    //@}
+    ///@}
 
 
     /**
         @name Connecting and disconnecting
     */
-    //@{
+    ///@{
 
     /**
         Connects the given function dynamically with the event handler, id and
@@ -871,13 +871,13 @@ public:
                     wxObjectEventFunction function = NULL,
                     wxObject* userData = NULL,
                     wxEvtHandler* eventSink = NULL);
-    //@}
+    ///@}
 
 
     /**
         @name Binding and Unbinding
     */
-    //@{
+    ///@{
 
     /**
         Binds the given function, functor or method dynamically with the event.
@@ -1032,11 +1032,11 @@ public:
                 int id = wxID_ANY,
                 int lastId = wxID_ANY,
                 wxObject *userData = NULL );
-    //@}
+    ///@}
     /**
         @name User-supplied data
     */
-    //@{
+    ///@{
 
     /**
         Returns user-supplied client data.
@@ -1078,7 +1078,7 @@ public:
     */
     void SetClientObject(wxClientData* data);
 
-    //@}
+    ///@}
 
 
     /**
@@ -1087,7 +1087,7 @@ public:
         wxEvtHandler can be arranged in a double-linked list of handlers
         which is automatically iterated by ProcessEvent() if needed.
     */
-    //@{
+    ///@{
 
     /**
         Returns @true if the event handler is enabled, @false otherwise.
@@ -1184,7 +1184,7 @@ public:
     */
     bool IsUnlinked() const;
 
-    //@}
+    ///@}
 
     /**
         @name Global event filters.
@@ -1194,7 +1194,7 @@ public:
         Event filters can be defined to pre-process all the events that happen
         in an application, see wxEventFilter documentation for more information.
      */
-    //@{
+    ///@{
 
     /**
         Add an event filter whose FilterEvent() method will be called for each
@@ -1218,7 +1218,7 @@ public:
      */
     static void RemoveFilter(wxEventFilter* filter);
 
-    //@}
+    ///@}
 
 protected:
     /**
@@ -1572,7 +1572,7 @@ public:
     */
     bool IsAutoRepeat() const;
 
-    //@{
+    ///@{
     /**
         Obtains the position (in client coordinates) at which the key was pressed.
 
@@ -1585,7 +1585,7 @@ public:
     */
     wxPoint GetPosition() const;
     void GetPosition(wxCoord* x, wxCoord* y) const;
-    //@}
+    ///@}
 
     /**
         Returns the raw key code for this event.

interface/wx/evtloop.h

@@ -71,7 +71,7 @@ public:
     /**
         @name Dispatch and processing
     */
-    //@{
+    ///@{
 
     /**
         Start the event loop, return the exit code when it is finished.
@@ -178,13 +178,13 @@ public:
      */
     virtual void WakeUp() = 0;
 
-    //@}
+    ///@}
 
 
     /**
         @name Idle handling
     */
-    //@{
+    ///@{
 
     /**
         Makes sure that idle events are sent again.
@@ -199,13 +199,13 @@ public:
     */
     virtual bool ProcessIdle();
 
-    //@}
+    ///@}
 
 
     /**
         @name Yield-related hooks
     */
-    //@{
+    ///@{
 
     /**
         Returns @true if called from inside Yield() or from inside YieldFor().
@@ -265,7 +265,7 @@ public:
     */
     virtual bool IsEventAllowedInsideYield(wxEventCategory cat) const;
 
-    //@}
+    ///@}
 
 
 protected:

interface/wx/filefn.h

@@ -353,7 +353,7 @@ bool wxRemoveFile(const wxString& file);
 enum wxPosixPermissions
 {
     /// Standard POSIX names for these permission flags with "wx" prefix.
-    //@{
+    ///@{
     wxS_IRUSR = 00400,
     wxS_IWUSR = 00200,
     wxS_IXUSR = 00100,
@@ -365,10 +365,10 @@ enum wxPosixPermissions
     wxS_IROTH = 00004,
     wxS_IWOTH = 00002,
     wxS_IXOTH = 00001,
-    //@}
+    ///@}
 
     /// Longer but more readable synonyms for the constants above.
-    //@{
+    ///@{
     wxPOSIX_USER_READ = wxS_IRUSR,
     wxPOSIX_USER_WRITE = wxS_IWUSR,
     wxPOSIX_USER_EXECUTE = wxS_IXUSR,
@@ -380,7 +380,7 @@ enum wxPosixPermissions
     wxPOSIX_OTHERS_READ = wxS_IROTH,
     wxPOSIX_OTHERS_WRITE = wxS_IWOTH,
     wxPOSIX_OTHERS_EXECUTE = wxS_IXOTH,
-    //@}
+    ///@}
 
     /// Default mode for the new files: allow reading/writing them to everybody but
     /// the effective file mode will be set after ANDing this value with umask and

interface/wx/filename.h

@@ -697,7 +697,7 @@ public:
     */
     static wxString GetHomeDir();
 
-    //@{
+    ///@{
     /**
         Returns the representation of the file size in a human-readable form.
 
@@ -731,7 +731,7 @@ public:
                          const wxString& nullsize = _("Not available"),
                          int precision = 1,
                          wxSizeConvention conv = wxSIZE_CONV_TRADITIONAL);
-    //@}
+    ///@}
 
     /**
         Return the long form of the path (returns identity on non-Windows platforms).
@@ -1399,7 +1399,7 @@ public:
     */
     bool ShouldFollowLink() const;
 
-    //@{
+    ///@{
     /**
         This function splits a full file name into components: the volume (with the
         first version) path (including the volume in the second version), the base name
@@ -1436,7 +1436,7 @@ public:
                           wxString* name,
                           wxString* ext,
                           wxPathFormat format = wxPATH_NATIVE);
-    //@}
+    ///@}
 
     /**
         Splits the given @a fullpath into the volume part (which may be empty) and

interface/wx/font.h

@@ -657,7 +657,7 @@ public:
     /**
         @name Getters
     */
-    //@{
+    ///@{
 
     /**
        Returns a font with the same face/size as the given one but with normal
@@ -853,7 +853,7 @@ public:
     */
     virtual bool IsOk() const;
 
-    //@}
+    ///@}
 
 
     /**
@@ -863,7 +863,7 @@ public:
         a new font similar to the given one but with its weight, style or size
         changed.
      */
-    //@{
+    ///@{
 
     /**
         Returns a bold version of this font.
@@ -1013,7 +1013,7 @@ public:
      */
     wxFont Scaled(float x) const;
 
-    //@}
+    ///@}
 
     /**
         @name Setters
@@ -1021,7 +1021,7 @@ public:
         These functions internally recreate the native font object with the new
         specified property.
     */
-    //@{
+    ///@{
 
     /**
         Sets the encoding for this font.
@@ -1231,7 +1231,7 @@ public:
     */
     virtual void SetNumericWeight(int weight);
 
-    //@}
+    ///@}
 
 
     /**
@@ -1288,7 +1288,7 @@ public:
      */
     static int GetNumericWeightOf(wxFontWeight weight);
 
-    //@{
+    ///@{
     /**
         This function takes the same parameters as the relative
         @ref wxFont::wxFont "wxFont constructor" and returns a new font
@@ -1323,7 +1323,7 @@ public:
     static wxFont *New(const wxNativeFontInfo& nativeInfo);
     static wxFont *New(const wxString& nativeInfoString);
 
-    //@}
+    ///@}
 };
 
 

interface/wx/fontdlg.h

@@ -52,14 +52,14 @@ public:
     */
     bool Create(wxWindow* parent, const wxFontData& data);
 
-    //@{
+    ///@{
     /**
         Returns the @ref wxFontData "font data" associated with the
         font dialog.
     */
     const wxFontData& GetFontData() const;
     wxFontData& GetFontData();
-    //@}
+    ///@}
 
     /**
         Shows the dialog, returning @c wxID_OK if the user pressed Ok, and

interface/wx/fontmap.h

@@ -103,7 +103,7 @@ public:
     */
     static const wxChar** GetAllEncodingNames(wxFontEncoding encoding);
 
-    //@{
+    ///@{
     /**
         Find an alternative for the given encoding (which is supposed to not be
         available on this system). If successful, return @true and fill info
@@ -122,7 +122,7 @@ public:
                            wxFontEncoding* alt_encoding,
                            const wxString& facename = wxEmptyString,
                            bool interactive = true);
-    //@}
+    ///@}
 
     /**
         Returns the @e n-th supported encoding.

interface/wx/fs_mem.h

@@ -76,7 +76,7 @@ public:
     */
     wxMemoryFSHandler();
 
-    //@{
+    ///@{
     /**
         Adds a file to the list of the files stored in memory.
 
@@ -99,9 +99,9 @@ public:
     static void AddFile(const wxString& filename, const wxString& textdata);
     static void AddFile(const wxString& filename, const void *binarydata, size_t size);
 
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Like AddFile(), but lets you explicitly specify added file's MIME type.
 
@@ -119,7 +119,7 @@ public:
                                     const void* binarydata,
                                     size_t size,
                                     const wxString& mimetype);
-    //@}
+    ///@}
 
     /**
         Removes a file from memory FS and frees the occupied memory.

interface/wx/gbsizer.h

@@ -79,7 +79,7 @@ public:
     */
     wxGridBagSizer(int vgap = 0, int hgap = 0);
 
-    //@{
+    ///@{
     /**
         Adds the given item to the given position.
 
@@ -105,14 +105,14 @@ public:
                      const wxGBSpan& span = wxDefaultSpan,
                      int flag = 0, int border = 0, wxObject* userData = NULL);
 
-    //@}
+    ///@}
     /**
         Called when the managed size of the sizer is needed or when layout
         needs done.
     */
     wxSize CalcMin();
 
-    //@{
+    ///@{
     /**
         Look at all items and see if any intersect (or would overlap) the given
         item. Returns @true if so, @false if there would be no overlap. If an
@@ -123,16 +123,16 @@ public:
                               wxGBSizerItem* excludeItem = NULL);
     bool CheckForIntersection(const wxGBPosition& pos, const wxGBSpan& span,
                               wxGBSizerItem* excludeItem = NULL);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Find the sizer item for the given window or subsizer, returns @NULL if
         not found. (non-recursive)
     */
     wxGBSizerItem* FindItem(wxWindow* window);
     wxGBSizerItem* FindItem(wxSizer* sizer);
-    //@}
+    ///@}
 
     /**
         Return the sizer item located at the point given in pt, or @NULL if
@@ -165,23 +165,23 @@ public:
     */
     wxSize GetEmptyCellSize() const;
 
-    //@{
+    ///@{
     /**
         Get the grid position of the specified item.
     */
     wxGBPosition GetItemPosition(wxWindow* window);
     wxGBPosition GetItemPosition(wxSizer* sizer);
     wxGBPosition GetItemPosition(size_t index);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Get the row/col spanning of the specified item.
     */
     wxGBSpan GetItemSpan(wxWindow* window);
     wxGBSpan GetItemSpan(wxSizer* sizer);
     wxGBSpan GetItemSpan(size_t index);
-    //@}
+    ///@}
 
     /**
         Called when the managed size of the sizer is needed or when layout
@@ -194,7 +194,7 @@ public:
     */
     void SetEmptyCellSize(const wxSize& sz);
 
-    //@{
+    ///@{
     /**
         Set the grid position of the specified item. Returns @true on success.
         If the move is not allowed (because an item is already there) then
@@ -203,9 +203,9 @@ public:
     bool SetItemPosition(wxWindow* window, const wxGBPosition& pos);
     bool SetItemPosition(wxSizer* sizer, const wxGBPosition& pos);
     bool SetItemPosition(size_t index, const wxGBPosition& pos);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Set the row/col spanning of the specified item. Returns @true on
         success. If the move is not allowed (because an item is already there)
@@ -214,7 +214,7 @@ public:
     bool SetItemSpan(wxWindow* window, const wxGBSpan& span);
     bool SetItemSpan(wxSizer* sizer, const wxGBSpan& span);
     bool SetItemSpan(size_t index, const wxGBSpan& span);
-    //@}
+    ///@}
 };
 
 
@@ -258,21 +258,21 @@ public:
     */
     void GetEndPos(int& row, int& col);
 
-    //@{
+    ///@{
     /**
         Get the grid position of the item.
     */
     wxGBPosition GetPos() const;
     void GetPos(int& row, int& col) const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Get the row and column spanning of the item.
     */
     wxGBSpan GetSpan() const;
     void GetSpan(int& rowspan, int& colspan) const;
-    //@}
+    ///@}
 
     /**
         Returns @true if this item and the @a other item intersect.

interface/wx/graphics.h

@@ -41,13 +41,13 @@ public:
         If there is a current point set, an initial line segment will be added
         to the path to connect the current point to the beginning of the arc.
     */
-    //@{
+    ///@{
     virtual void AddArc(wxDouble x, wxDouble y, wxDouble r,
                         wxDouble startAngle, wxDouble endAngle,
                         bool clockwise);
     void AddArc(const wxPoint2DDouble& c, wxDouble r,
                 wxDouble startAngle, wxDouble endAngle, bool clockwise);
-    //@}
+    ///@}
 
     /**
         Adds an arc (of a circle with radius @a r) that is tangent
@@ -1301,10 +1301,10 @@ public:
     /**
         Add a new stop.
     */
-    //@{
+    ///@{
     void Add(const wxGraphicsGradientStop& stop);
     void Add(wxColour col, float pos);
-    //@}
+    ///@}
 
     /**
         Returns the stop at the given index.

interface/wx/hash.h

@@ -72,13 +72,13 @@ public:
     */
     void Clear();
 
-    //@{
+    ///@{
     /**
         Deletes entry in hash table and returns the user's data (if found).
     */
     wxObject* Delete(long key);
     wxObject* Delete(const wxString& key);
-    //@}
+    ///@}
 
     /**
         If set to @true data stored in hash table will be deleted when hash table
@@ -86,14 +86,14 @@ public:
     */
     void DeleteContents(bool flag);
 
-    //@{
+    ///@{
     /**
         Gets data from the hash table, using an integer or string key
         (depending on which has table constructor was used).
     */
     wxObject* Get(long key);
     wxObject* Get(const char* key);
-    //@}
+    ///@}
 
     /**
         Returns the number of elements in the hash table.
@@ -117,7 +117,7 @@ public:
     */
     wxHashTable::Node* Next();
 
-    //@{
+    ///@{
     /**
         Inserts data into the hash table, using an integer or string key (depending on
         which has table constructor was used).
@@ -125,6 +125,6 @@ public:
     */
     void Put(long key, wxObject* object);
     void Put(const char* key, wxObject* object);
-    //@}
+    ///@}
 };
 

interface/wx/hashmap.h

@@ -174,14 +174,14 @@ public:
     */
     wxHashMap(const wxHashMap& map);
 
-    //@{
+    ///@{
     /**
         Returns an iterator pointing at the first element of the hash map.
         Please remember that hash maps do not guarantee ordering.
     */
     const_iterator begin() const;
     iterator begin();
-    //@}
+    ///@}
 
     /**
         Removes all elements from the hash map.
@@ -199,16 +199,16 @@ public:
     */
     bool empty() const;
 
-    //@{
+    ///@{
     /**
         Returns an iterator pointing at the one-after-the-last element of the hash map.
         Please remember that hash maps do not guarantee ordering.
     */
     const_iterator end() const;
     iterator end();
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Erases the element with the given key, and returns the number of elements
         erased (either 0 or 1).
@@ -221,9 +221,9 @@ public:
     */
     void erase(iterator it);
     void erase(const_iterator it);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         If an element with the given key is present, the functions returns an
         iterator pointing at that element, otherwise an invalid iterator is
@@ -235,7 +235,7 @@ public:
     */
     iterator find(const key_type& key) const;
     const_iterator find(const key_type& key) const;
-    //@}
+    ///@}
 
     /**
         Inserts the given value in the hash map.

interface/wx/hashset.h

@@ -151,14 +151,14 @@ public:
     */
     wxHashSet(const wxHashSet& set);
 
-    //@{
+    ///@{
     /**
         Returns an iterator pointing at the first element of the hash set.
         Please remember that hash sets do not guarantee ordering.
     */
     const_iterator begin() const;
     iterator begin();
-    //@}
+    ///@}
 
     /**
         Removes all elements from the hash set.
@@ -176,14 +176,14 @@ public:
     */
     bool empty() const;
 
-    //@{
+    ///@{
     /**
         Returns an iterator pointing at the one-after-the-last element of the hash set.
         Please remember that hash sets do not guarantee ordering.
     */
     const_iterator end() const;
     iterator end();
-    //@}
+    ///@}
 
     /**
         Erases the element with the given key, and returns the number of elements
@@ -191,16 +191,16 @@ public:
     */
     size_type erase(const key_type& key);
 
-    //@{
+    ///@{
     /**
         Erases the element pointed to by the iterator. After the deletion
         the iterator is no longer valid and must not be used.
     */
     void erase(iterator it);
     void erase(const_iterator it);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         If an element with the given key is present, the functions returns
         an iterator pointing at that element, otherwise an invalid iterator
@@ -212,7 +212,7 @@ public:
     */
     iterator find(const key_type& key) const;
     const_iterator find(const key_type& key) const;
-    //@}
+    ///@}
 
     /**
         Inserts the given value in the hash set.

interface/wx/headercol.h

@@ -409,7 +409,7 @@ public:
 class wxHeaderColumnSimple : public wxSettableHeaderColumn
 {
 public:
-    //@{
+    ///@{
     /**
         Constructor for a column header.
 
@@ -425,9 +425,9 @@ public:
                          int width = wxCOL_WIDTH_DEFAULT,
                          wxAlignment align = wxALIGN_CENTER,
                          int flags = wxCOL_DEFAULT_FLAGS);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
 
     /// Trivial implementations of the base class pure virtual functions.
 
@@ -448,5 +448,5 @@ public:
     virtual void SetSortOrder(bool ascending);
     virtual bool IsSortOrderAscending() const;
 
-    //@}
+    ///@}
 };

interface/wx/htmllbox.h

@@ -64,7 +64,7 @@ public:
                 long style = 0,
                 const wxString& name = wxHtmlListBoxNameStr);
 
-    //@{
+    ///@{
     /**
         Returns the wxFileSystem used by the HTML parser of this object.
 
@@ -75,7 +75,7 @@ public:
     */
     wxFileSystem& GetFileSystem() const;
     const wxFileSystem& GetFileSystem() const;
-    //@}
+    ///@}
 
 protected:
 
@@ -278,7 +278,7 @@ public:
     */
     virtual ~wxSimpleHtmlListBox();
 
-    //@{
+    ///@{
     /**
         Creates the HTML listbox for two-step construction.
         See wxSimpleHtmlListBox() for further details.
@@ -297,6 +297,6 @@ public:
                 long style = wxHLB_DEFAULT_STYLE,
                 const wxValidator& validator = wxDefaultValidator,
                 const wxString& name = wxSimpleHtmlListBoxNameStr);
-    //@}
+    ///@}
 };
 

interface/wx/image.h

@@ -710,7 +710,7 @@ public:
     /**
         @name Image creation, initialization and deletion functions
     */
-    //@{
+    ///@{
 
     /**
         Returns an identical copy of this image.
@@ -779,13 +779,13 @@ public:
     */
     void InitAlpha();
 
-    //@}
+    ///@}
 
 
     /**
         @name Image manipulation functions
     */
-    //@{
+    ///@{
 
     /**
         Blurs the image in both horizontal and vertical directions by the
@@ -1006,13 +1006,13 @@ public:
     wxImage Size(const wxSize& size, const wxPoint& pos, int red = -1,
                  int green = -1, int blue = -1) const;
 
-    //@}
+    ///@}
 
 
     /**
         @name Conversion functions
     */
-    //@{
+    ///@{
 
     /**
         If the image has alpha channel, this method converts it to mask.
@@ -1108,13 +1108,13 @@ public:
     */
     wxImage ChangeLightness(int alpha) const;
 
-    //@}
+    ///@}
 
 
     /**
         @name Miscellaneous functions
     */
-    //@{
+    ///@{
 
     /**
         Computes the histogram of the image. @a histogram is a reference to
@@ -1172,13 +1172,13 @@ public:
     */
     wxImage& operator=(const wxImage& image);
 
-    //@}
+    ///@}
 
 
     /**
         @name Getters
     */
-    //@{
+    ///@{
 
     /**
         Returns pointer to the array storing the alpha values for this image.
@@ -1476,13 +1476,13 @@ public:
     bool IsTransparent(int x, int y,
                        unsigned char threshold = wxIMAGE_ALPHA_THRESHOLD) const;
 
-    //@}
+    ///@}
 
 
     /**
         @name Loading and saving functions
     */
-    //@{
+    ///@{
 
     /**
         Loads an image from an input stream.
@@ -1662,14 +1662,14 @@ public:
     */
     virtual bool SaveFile(wxOutputStream& stream, wxBitmapType type) const;
 
-    //@}
+    ///@}
 
 
 
     /**
         @name Setters
     */
-    //@{
+    ///@{
 
     /**
        This function is similar to SetData() and has similar restrictions.
@@ -1867,14 +1867,14 @@ public:
     */
     void SetType(wxBitmapType type);
 
-    //@}
+    ///@}
 
 
 
     /**
         @name Handler management functions
     */
-    //@{
+    ///@{
 
     /**
         Register an image handler.
@@ -1994,7 +1994,7 @@ public:
     */
     static bool RemoveHandler(const wxString& name);
 
-    //@}
+    ///@}
 
 
     /**
@@ -2022,7 +2022,7 @@ public:
      */
     static int GetDefaultLoadFlags();
 
-    //@{
+    ///@{
     /**
         If the image file contains more than one image and the image handler is
         capable of retrieving these individually, this function will return the
@@ -2059,7 +2059,7 @@ public:
                              wxBitmapType type = wxBITMAP_TYPE_ANY);
     static int GetImageCount(wxInputStream& stream,
                              wxBitmapType type = wxBITMAP_TYPE_ANY);
-    //@}
+    ///@}
 
     /**
         Iterates all registered wxImageHandler objects, and returns a string containing

interface/wx/infobar.h

@@ -231,7 +231,7 @@ public:
         wxMSW). The methods here allow to change the default effect used (or
         disable it entirely) and change its duration.
      */
-    //@{
+    ///@{
 
     /**
         Set the effects to use when showing and hiding the bar.
@@ -283,5 +283,5 @@ public:
      */
     virtual bool SetFont(const wxFont& font);
 
-    //@}
+    ///@}
 };

interface/wx/intl.h

@@ -53,14 +53,14 @@ struct wxLanguageInfo
     */
     wxString CanonicalRef;
 
-    //@{
+    ///@{
     /**
         Win32 language identifiers (LANG_xxxx, SUBLANG_xxxx).
 
         @onlyfor{wxmsw}
     */
     wxUint32 WinLang, WinSublang;
-    //@}
+    ///@}
 
     /// Human-readable name of the language in English.
     wxString Description;

interface/wx/ipc.h

@@ -29,7 +29,7 @@
 class wxConnection : public wxObject
 {
 public:
-    //@{
+    ///@{
     /**
         Constructs a connection object.
 
@@ -52,9 +52,9 @@ public:
     */
     wxConnection();
     wxConnection(void* buffer, size_t size);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Called by the server application to advise the client of a change
         in the data associated with the given item. Causes the client
@@ -67,7 +67,7 @@ public:
     bool Advise(const wxString& item, const char* data);
     bool Advise(const wxString& item, const wchar_t* data);
     bool Advise(const wxString& item, const wxString data);
-    //@}
+    ///@}
 
     /**
         Called by the client or server application to disconnect from the
@@ -80,7 +80,7 @@ public:
     */
     bool Disconnect();
 
-    //@{
+    ///@{
     /**
         Called by the client application to execute a command on the server.
         Can also be used to transfer arbitrary data to the server (similar to
@@ -92,7 +92,7 @@ public:
     bool Execute(const char* data);
     bool Execute(const wchar_t* data);
     bool Execute(const wxString data);
-    //@}
+    ///@}
 
     /**
         Message sent to the client application when the server notifies it of a
@@ -161,7 +161,7 @@ public:
     virtual bool OnStopAdvise(const wxString& topic,
                               const wxString& item);
 
-    //@{
+    ///@{
     /**
         Called by the client application to poke data into the server.
         Can be used to transfer arbitrary data to the server.
@@ -175,7 +175,7 @@ public:
     bool Poke(const wxString& item, const char* data);
     bool Poke(const wxString& item, const wchar_t* data);
     bool Poke(const wxString& item, const wxString data);
-    //@}
+    ///@}
 
     /**
         Called by the client application to request data from the server.

interface/wx/listbox.h

@@ -141,7 +141,7 @@ public:
     */
     virtual ~wxListBox();
 
-    //@{
+    ///@{
     /**
         Creates the listbox for two-step construction.
         See wxListBox() for further details.
@@ -160,7 +160,7 @@ public:
                 long style = 0,
                 const wxValidator& validator = wxDefaultValidator,
                 const wxString& name = wxListBoxNameStr);
-    //@}
+    ///@}
 
     /**
         Deselects an item in the list box.

interface/wx/listctrl.h

@@ -2082,14 +2082,14 @@ public:
     */
     void SetColumn(int col);
 
-    //@{
+    ///@{
     /**
         Sets client data for the item.
         Please note that client data is associated with the item and not with subitems.
     */
     void SetData(long data);
     void SetData(void* data);
-    //@}
+    ///@}
 
     /**
         Sets the font for the item.

interface/wx/log.h

@@ -222,7 +222,7 @@ public:
     /**
         @name Trace mask functions
     */
-    //@{
+    ///@{
 
     /**
         Add the @a mask to the list of allowed masks for wxLogTrace().
@@ -260,14 +260,14 @@ public:
     */
     static void RemoveTraceMask(const wxString& mask);
 
-    //@}
+    ///@}
 
 
 
     /**
         @name Log target functions
     */
-    //@{
+    ///@{
 
     /**
         Instructs wxLog to not create new log targets on the fly if there is none
@@ -369,14 +369,14 @@ public:
     */
     static void Suspend();
 
-    //@}
+    ///@}
 
 
 
     /**
         @name Log level functions
     */
-    //@{
+    ///@{
 
     /**
         Returns the current log level limit.
@@ -431,14 +431,14 @@ public:
     */
     static void SetLogLevel(wxLogLevel logLevel);
 
-    //@}
+    ///@}
 
 
 
     /**
         @name Enable/disable features functions
     */
-    //@{
+    ///@{
 
     /**
         Globally enable or disable logging.
@@ -520,7 +520,7 @@ public:
     */
     static void SetVerbose(bool verbose = true);
 
-    //@}
+    ///@}
 
 
     /**
@@ -594,7 +594,7 @@ protected:
         messages formatting but want to handle log messages of different levels
         differently or, in the simplest case, DoLogText().
      */
-    //@{
+    ///@{
 
     /**
         Called to log a new record.
@@ -633,7 +633,7 @@ protected:
     */
     virtual void DoLogText(const wxString& msg);
 
-    //@}
+    ///@}
 };
 
 

interface/wx/longlong.h

@@ -59,14 +59,14 @@ public:
     */
     wxLongLong(long hi, unsigned long lo);
 
-    //@{
+    ///@{
     /**
         Returns an absolute value of wxLongLong - either making a copy (const version)
         or modifying it in place (the second one).
     */
     wxLongLong Abs() const;
     wxLongLong& Abs();
-    //@}
+    ///@}
 
     /**
         This allows converting a double value to wxLongLong type.
@@ -131,21 +131,21 @@ public:
     wxLongLong& operator-(const wxLongLong& ll);
 
 
-    //@{
+    ///@{
     /**
         Pre/post increment operator.
     */
     wxLongLong operator++();
     wxLongLong operator++(int);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Pre/post decrement operator.
     */
     wxLongLong operator--();
     wxLongLong operator--(int);
-    //@}
+    ///@}
 
     /**
         Returns the value of this wxLongLong with opposite sign.
@@ -273,21 +273,21 @@ public:
     wxULongLong& operator-(const wxULongLong& ll);
 
 
-    //@{
+    ///@{
     /**
         Pre/post increment operator.
     */
     wxULongLong operator++();
     wxULongLong operator++(int);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Pre/post decrement operator.
     */
     wxULongLong operator--();
     wxULongLong operator--(int);
-    //@}
+    ///@}
 
     /**
         Assignment operator from signed long long. The sign bit will be copied too.

interface/wx/menu.h

@@ -833,7 +833,7 @@ public:
     */
     size_t GetMenuItemCount() const;
 
-    //@{
+    ///@{
     /**
         Returns the list of items in the menu.
 
@@ -842,7 +842,7 @@ public:
     */
     wxMenuItemList& GetMenuItems();
     const wxMenuItemList& GetMenuItems() const;
-    //@}
+    ///@}
 
     /**
         Returns the title of the menu.

interface/wx/menuitem.h

@@ -151,7 +151,7 @@ public:
     /**
         @name Getters
     */
-    //@{
+    ///@{
 
     /**
         Returns the background colour associated with the menu item.
@@ -298,14 +298,14 @@ public:
     */
     virtual wxAcceleratorEntry *GetAccel() const;
 
-    //@}
+    ///@}
 
 
 
     /**
         @name Checkers
     */
-    //@{
+    ///@{
 
     /**
         Returns @true if the item is a check item.
@@ -352,14 +352,14 @@ public:
     */
     bool IsSubMenu() const;
 
-    //@}
+    ///@}
 
 
 
     /**
         @name Setters
     */
-    //@{
+    ///@{
 
     /**
         Sets the background colour associated with the menu item.
@@ -614,6 +614,6 @@ public:
     */
     void ClearExtraAccels();
 
-    //@}
+    ///@}
 };
 

interface/wx/mimetype.h

@@ -348,7 +348,7 @@ public:
     */
     bool GetMimeTypes(wxArrayString& mimeTypes) const;
 
-    //@{
+    ///@{
     /**
         With the first version of this method, if the @true is returned, the
         string pointed to by @a command is filled with the command which must be
@@ -364,7 +364,7 @@ public:
     */
     bool GetOpenCommand(wxString* command, const MessageParameters& params);
     wxString GetOpenCommand(const wxString& filename) const;
-    //@}
+    ///@}
 
     /**
         If the function returns @true, the string pointed to by @a command is filled

interface/wx/mousestate.h

@@ -74,10 +74,10 @@ public:
     /**
         Returns the physical mouse position.
     */
-    //@{
+    ///@{
     wxPoint GetPosition() const;
     void GetPosition(int *x, int *y) const;
-    //@}
+    ///@}
 
     /**
         Returns @true if the left mouse button is currently down.

interface/wx/numformatter.h

@@ -74,11 +74,11 @@ public:
             Combination of values from the Style enumeration (except for
             Style_NoTrailingZeroes which can't be used with this overload).
     */
-    //@{
+    ///@{
     static wxString ToString(long val, int flags = Style_WithThousandsSep);
     static wxString ToString(long long val, int flags = Style_WithThousandsSep);
     static wxString ToString(unsigned long long val, int flags = Style_WithThousandsSep);
-    //@}
+    ///@}
 
     /**
         Returns string representation of a floating point number.
@@ -120,12 +120,12 @@ public:
 
         @see wxString::ToLong(), wxString::ToDouble()
      */
-    //@{
+    ///@{
     static bool FromString(wxString s, long *val);
     static bool FromString(wxString s, long long *val);
     static bool FromString(wxString s, unsigned long long *val);
     static bool FromString(wxString s, double *val);
-    //@}
+    ///@}
 
     /**
         Get the decimal separator for the current UI locale.

interface/wx/object.h

@@ -585,7 +585,7 @@ public:
     */
     wxObjectDataPtr(T* ptr = NULL);
 
-    //@{
+    ///@{
     /**
         This copy constructor increases the count of the reference counted object to
         which @a tocopy points and then this class will point to, as well.
@@ -595,7 +595,7 @@ public:
     template <typename U>
     wxObjectDataPtr(const wxObjectDataPtr<U>& tocopy);
     wxObjectDataPtr(const wxObjectDataPtr<T>& tocopy);
-    //@}
+    ///@}
 
 
     /**
@@ -652,7 +652,7 @@ public:
     */
     T* operator->() const;
 
-    //@{
+    ///@{
     /**
         Assignment operator.
 
@@ -662,7 +662,7 @@ public:
     wxObjectDataPtr<T>& operator=(const wxObjectDataPtr<U>& tocopy);
     wxObjectDataPtr<T>& operator=(const wxObjectDataPtr<T>& tocopy);
     wxObjectDataPtr<T>& operator=(T* ptr);
-    //@}
+    ///@}
 };
 
 

interface/wx/odcombo.h

@@ -163,7 +163,7 @@ public:
     */
     virtual ~wxOwnerDrawnComboBox();
 
-    //@{
+    ///@{
     /**
         Creates the combobox for two-step construction.
         See wxOwnerDrawnComboBox() for further details.
@@ -197,7 +197,7 @@ public:
                 long style = 0,
                 const wxValidator& validator = wxDefaultValidator,
                 const wxString& name = wxComboBoxNameStr);
-    //@}
+    ///@}
 
     /**
         IsEmpty() is not available in this class.

interface/wx/persist.h

@@ -153,12 +153,12 @@ public:
     void SaveAndUnregister(void *obj);
 
     /// Combines both Register() and Restore() calls.
-    //@{
+    ///@{
     template <class T>
     bool RegisterAndRestore(T *obj);
 
     bool RegisterAndRestore(void *obj, wxPersistentObject *po);
-    //@}
+    ///@}
 
 protected:
     /**
@@ -239,7 +239,7 @@ public:
         Notice that these methods are only used by wxPersistenceManager
         normally and shouldn't be called directly.
      */
-    //@{
+    ///@{
 
     /**
         Save the object properties.
@@ -274,7 +274,7 @@ public:
      */
     virtual wxString GetName() const = 0;
 
-    //@}
+    ///@}
 
 
     /// Return the associated object.

interface/wx/platinfo.h

@@ -278,7 +278,7 @@ public:
 
         These getters allow for easy string-to-enumeration-value conversion.
     */
-    //@{
+    ///@{
 
     /**
         Converts the given string to a wxBitness enum value or to
@@ -314,7 +314,7 @@ public:
     */
     static wxPortId GetPortId(const wxString& portname);
 
-    //@}
+    ///@}
 
 
     /**
@@ -322,7 +322,7 @@ public:
 
         These getters allow for easy enumeration-value-to-string conversion.
     */
-    //@{
+    ///@{
 
     /**
         @deprecated Use GetBitnessName() instead.
@@ -382,13 +382,13 @@ public:
     */
     static wxString GetOperatingSystemDirectory();
 
-    //@}
+    ///@}
 
 
     /**
         @name Getters
     */
-    //@{
+    ///@{
 
     /**
         @deprecated Use GetBitness() instead.
@@ -525,13 +525,13 @@ public:
     */
     int GetToolkitMicroVersion() const;
 
-    //@}
+    ///@}
 
 
     /**
         @name String-form getters
     */
-    //@{
+    ///@{
 
     /**
         @deprecated Use GetBitnessName() instead.
@@ -574,14 +574,14 @@ public:
     */
     wxString GetPortIdShortName() const;
 
-    //@}
+    ///@}
 
 
 
     /**
         @name Setters
     */
-    //@{
+    ///@{
 
     /**
         @deprecated Use SetBitness() instead.
@@ -636,7 +636,7 @@ public:
     */
     void SetLinuxDistributionInfo(const wxLinuxDistributionInfo& di);
 
-    //@}
+    ///@}
 };
 
 /**

interface/wx/position.h

@@ -78,6 +78,6 @@ public:
     wxPosition operator -(const wxPosition& pos) const;
     wxPosition operator +(const wxSize& size) const;
     wxPosition operator -(const wxSize& size) const;
-    //@}
+    ///@}
 };
 

interface/wx/rawbmp.h

@@ -205,7 +205,7 @@ public:
         */
         void MoveTo(const PixelData& data, int x, int y);
 
-        //@{
+        ///@{
         /**
             Data Access: Access to individual colour components.
         */
@@ -213,7 +213,7 @@ public:
         ChannelType& Green();
         ChannelType& Blue();
         ChannelType& Alpha();
-        //@}
+        ///@}
     };
 };
 

interface/wx/regex.h

@@ -269,7 +269,7 @@ public:
     */
     bool IsValid() const;
 
-    //@{
+    ///@{
     /**
         Matches the precompiled regular expression against the string @a text,
         returns @true if matches and @false otherwise.
@@ -291,7 +291,7 @@ public:
     */
     bool Matches(const wxChar* text, int flags = 0) const;
     bool Matches(const wxChar* text, int flags, size_t len) const;
-    //@}
+    ///@}
 
     /**
         Matches the precompiled regular expression against the string @a text,

interface/wx/region.h

@@ -260,7 +260,7 @@ public:
     */
     wxBitmap ConvertToBitmap() const;
 
-    //@{
+    ///@{
     /**
         Returns the outer bounds of the region.
 
@@ -269,7 +269,7 @@ public:
     void GetBox(wxCoord& x, wxCoord& y, wxCoord& width,
                 wxCoord& height) const;
     wxRect GetBox() const;
-    //@}
+    ///@}
 
     /**
         Finds the intersection of this region and another, rectangular region,
@@ -329,7 +329,7 @@ public:
     */
     bool IsEqual(const wxRegion& region) const;
 
-    //@{
+    ///@{
     /**
         Moves the region by the specified offsets in horizontal and vertical
         directions.
@@ -343,7 +343,7 @@ public:
     */
     bool Offset(wxCoord x, wxCoord y);
     bool Offset(const wxPoint& pt);
-    //@}
+    ///@}
 
     /**
         Subtracts a rectangular region from this region.

interface/wx/richtooltip.h

@@ -126,10 +126,10 @@ public:
         unsupported by the native MSW implementation of this class so the use
         of a standard icon is preferred.
      */
-    //@{
+    ///@{
     void SetIcon(int icon = wxICON_INFORMATION);
     void SetIcon(const wxBitmapBundle& icon);
-    //@}
+    ///@}
 
     /**
         Set timeout after which the tooltip should disappear and

interface/wx/sckipc.h

@@ -172,7 +172,7 @@ public:
 class wxTCPConnection : public wxObject
 {
 public:
-    //@{
+    ///@{
     /**
         Constructs a connection object.
 
@@ -191,9 +191,9 @@ public:
     */
     wxTCPConnection();
     wxTCPConnection(void* buffer, size_t size);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Called by the server application to advise the client of a change in
         the data associated with the given item.
@@ -207,7 +207,7 @@ public:
     bool Advise(const wxString& item, const char* data);
     bool Advise(const wxString& item, const wchar_t* data);
     bool Advise(const wxString& item, const wxString data);
-    //@}
+    ///@}
 
     /**
         Called by the client or server application to disconnect from the other
@@ -222,7 +222,7 @@ public:
     */
     virtual bool Disconnect();
 
-    //@{
+    ///@{
     /**
         Called by the client application to execute a command on the server.
         Can also be used to transfer arbitrary data to the server (similar
@@ -236,7 +236,7 @@ public:
     bool Execute(const char* data);
     bool Execute(const wchar_t* data);
     bool Execute(const wxString data);
-    //@}
+    ///@}
 
     /**
         Message sent to the client application when the server notifies it of a
@@ -301,7 +301,7 @@ public:
     virtual bool OnStopAdvise(const wxString& topic,
                               const wxString& item);
 
-    //@{
+    ///@{
     /**
         Called by the client application to poke data into the server.
         Can be used to transfer arbitrary data to the server. Causes the server
@@ -312,7 +312,7 @@ public:
     bool Poke(const wxString& item, const char* data);
     bool Poke(const wxString& item, const wchar_t* data);
     bool Poke(const wxString& item, const wxString data);
-    //@}
+    ///@}
 
     /**
         Called by the client application to request data from the server.

interface/wx/sizer.h

@@ -440,7 +440,7 @@ public:
     virtual bool InformFirstDirection(int direction, int size, int availableOtherDir);
 
 
-    //@{
+    ///@{
     /**
         Returns the list of the items in this sizer.
 
@@ -449,7 +449,7 @@ public:
     */
     wxSizerItemList& GetChildren();
     const wxSizerItemList& GetChildren() const;
-    //@}
+    ///@}
 
     /**
         Returns the window this sizer is used in or @NULL if none.
@@ -867,7 +867,7 @@ public:
             @true if the minimal size was successfully set or @false if the
             item was not found.
     */
-    //@{
+    ///@{
     bool SetItemMinSize(wxWindow* window, int width, int height);
     bool SetItemMinSize(wxWindow* window, const wxSize& size);
 
@@ -876,7 +876,7 @@ public:
 
     bool SetItemMinSize(size_t index, int width, int height);
     bool SetItemMinSize(size_t index, const wxSize& size);
-    //@}
+    ///@}
 
     /**
         Call this to give the sizer a minimal size.
@@ -1093,7 +1093,7 @@ public:
     wxSizerItem(int width, int height, int proportion=0, int flag=0,
                 int border=0, wxObject* userData=NULL);
 
-    //@{
+    ///@{
     /**
         Construct a sizer item for tracking a window.
     */
@@ -1101,9 +1101,9 @@ public:
     wxSizerItem(wxWindow* window, int proportion=0, int flag=0,
                 int border=0,
                 wxObject* userData=NULL);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Construct a sizer item for tracking a subsizer.
     */
@@ -1111,7 +1111,7 @@ public:
     wxSizerItem(wxSizer* sizer, int proportion=0, int flag=0,
                 int border=0,
                 wxObject* userData=NULL);
-    //@}
+    ///@}
 
     /**
         Deletes the user data and subsizer, if any.
@@ -1144,7 +1144,7 @@ public:
     */
     void AssignSizer(wxSizer *sizer);
 
-    //@{
+    ///@{
     /**
         Set the size of the spacer tracked by this item.
 
@@ -1152,7 +1152,7 @@ public:
     */
     void AssignSpacer(const wxSize& size);
     void AssignSpacer(int w, int h);
-    //@}
+    ///@}
 
     /**
         Calculates the minimum desired size for the item, including any space
@@ -1315,14 +1315,14 @@ public:
     */
     void SetProportion(int proportion);
 
-    //@{
+    ///@{
     /**
         Set the ratio item attribute.
     */
     void SetRatio(int width, int height);
     void SetRatio(wxSize size);
     void SetRatio(float ratio);
-    //@}
+    ///@}
 
     /**
         Set the sizer tracked by this item.
@@ -1665,7 +1665,7 @@ enum wxFlexSizerGrowMode
 class wxFlexGridSizer : public wxGridSizer
 {
 public:
-    //@{
+    ///@{
     /**
         wxFlexGridSizer constructors.
 
@@ -1678,7 +1678,7 @@ public:
 
     wxFlexGridSizer( int rows, int cols, int vgap, int hgap );
     wxFlexGridSizer( int rows, int cols, const wxSize& gap );
-    //@}
+    ///@}
 
     /**
         Specifies that column @a idx (starting from zero) should be grown if
@@ -1822,7 +1822,7 @@ public:
 class wxGridSizer : public wxSizer
 {
 public:
-    //@{
+    ///@{
     /**
         wxGridSizer constructors.
 
@@ -1854,7 +1854,7 @@ public:
 
     wxGridSizer( int rows, int cols, int vgap, int hgap );
     wxGridSizer( int rows, int cols, const wxSize& gap );
-    //@}
+    ///@}
 
     /**
         Returns the number of columns that has been specified for the

interface/wx/socket.h

@@ -732,7 +732,7 @@ public:
     /**
         @name Construction and Destruction
     */
-    //@{
+    ///@{
 
     /**
         Default constructor.
@@ -798,13 +798,13 @@ public:
      */
     static void Shutdown();
 
-    //@}
+    ///@}
 
 
     /**
         @name Socket State
     */
-    //@{
+    ///@{
 
     /**
         Returns @true if an error occurred in the last IO operation.
@@ -941,7 +941,7 @@ public:
     */
     void SaveState();
 
-    //@}
+    ///@}
 
 
     /**
@@ -949,7 +949,7 @@ public:
 
         See also: wxSocketServer::WaitForAccept(), wxSocketClient::WaitOnConnect()
     */
-    //@{
+    ///@{
 
     /**
         Shut down the socket, disabling further transmission and reception of
@@ -1331,13 +1331,13 @@ public:
     */
     wxSocketBase& WriteMsg(const void* buffer, wxUint32 nbytes);
 
-    //@}
+    ///@}
 
 
     /**
         @name Handling Socket Events
     */
-    //@{
+    ///@{
 
     /**
         Returns a pointer of the client data for this socket, as set with
@@ -1421,7 +1421,7 @@ public:
     */
     wxSOCKET_T GetSocket() const;
 
-    //@}
+    ///@}
 };
 
 

interface/wx/sound.h

@@ -99,7 +99,7 @@ public:
     */
     static bool IsPlaying();
 
-    //@{
+    ///@{
     /**
         Plays the sound file. If another sound is playing, it will be interrupted.
 
@@ -123,7 +123,7 @@ public:
     bool Play(unsigned flags = wxSOUND_ASYNC) const;
     static bool Play(const wxString& filename,
                      unsigned flags = wxSOUND_ASYNC);
-    //@}
+    ///@}
 
     /**
         If a sound is played, this function stops it.

interface/wx/stack.h

@@ -47,10 +47,10 @@ public:
         Stack can be created either empty or initialized with the contents of
         an existing compatible container.
      */
-    //@{
+    ///@{
     wxStack();
     explicit wxStack(const container_type& cont);
-    //@}
+    ///@}
 
     /// Return whether the stack is currently empty.
     bool empty() const;
@@ -61,10 +61,10 @@ public:
     /**
         Return the element on top of the stack.
      */
-    //@{
+    ///@{
     value_type& top();
     const value_type& top();
-    //@}
+    ///@}
 
     /// Adds an element to the stack.
     void push(const value_type& val);

interface/wx/strconv.h

@@ -231,7 +231,7 @@ public:
      */
     wxWCharBuffer cMB2WC(const wxCharBuffer& buf) const;
 
-    //@{
+    ///@{
     /**
         Converts from multibyte encoding to the current wxChar type (which
         depends on whether wxUSE_UNICODE is set to 1).
@@ -242,7 +242,7 @@ public:
     */
     const char* cMB2WX(const char* psz) const;
     wxWCharBuffer cMB2WX(const char* psz) const;
-    //@}
+    ///@}
 
     /**
         Converts from Unicode to multibyte encoding by calling FromWChar() and
@@ -275,7 +275,7 @@ public:
      */
     wxCharBuffer cWC2MB(const wxWCharBuffer& buf) const;
 
-    //@{
+    ///@{
     /**
         Converts from Unicode to the current wxChar type.
 
@@ -285,9 +285,9 @@ public:
     */
     const wchar_t* cWC2WX(const wchar_t* psz) const;
     wxCharBuffer cWC2WX(const wchar_t* psz) const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Converts from the current wxChar type to multibyte encoding.
 
@@ -297,9 +297,9 @@ public:
     */
     const char* cWX2MB(const wxChar* psz) const;
     wxCharBuffer cWX2MB(const wxChar* psz) const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Converts from the current wxChar type to Unicode.
 
@@ -309,7 +309,7 @@ public:
     */
     const wchar_t* cWX2WC(const wxChar* psz) const;
     wxWCharBuffer cWX2WC(const wxChar* psz) const;
-    //@}
+    ///@}
 
     /**
         @deprecated This function is deprecated, please use ToWChar() instead.

interface/wx/stream.h

@@ -877,7 +877,7 @@ public:
     static const wxFilterClassFactory* Find(const wxString& protocol,
                                             wxStreamProtocolType type = wxSTREAM_PROTOCOL);
 
-    //@{
+    ///@{
     /**
         GetFirst and GetNext can be used to enumerate the available factories.
         For example, to list them:
@@ -897,7 +897,7 @@ public:
     */
     static const wxFilterClassFactory* GetFirst();
     const wxFilterClassFactory* GetNext() const;
-    //@}
+    ///@}
 
     /**
         Returns the wxFileSystem protocol supported by this factory.
@@ -922,7 +922,7 @@ public:
     */
     virtual const wxChar * const* GetProtocols(wxStreamProtocolType type = wxSTREAM_PROTOCOL) const = 0;
 
-    //@{
+    ///@{
     /**
         Create a new input or output stream to decompress or compress a given stream.
 
@@ -933,7 +933,7 @@ public:
     virtual wxFilterOutputStream* NewStream(wxOutputStream& stream) const = 0;
     virtual wxFilterInputStream*  NewStream(wxInputStream* stream) const = 0;
     virtual wxFilterOutputStream* NewStream(wxOutputStream* stream) const = 0;
-    //@}
+    ///@}
 
     /**
         Remove the file extension of @a location if it is one of the file
@@ -987,7 +987,7 @@ public:
 class wxFilterOutputStream : public wxOutputStream
 {
 public:
-    //@{
+    ///@{
     /**
         Initializes a "filter" stream.
 
@@ -996,7 +996,7 @@ public:
     */
     wxFilterOutputStream(wxOutputStream& stream);
     wxFilterOutputStream(wxOutputStream* stream);
-    //@}
+    ///@}
 };
 
 
@@ -1020,7 +1020,7 @@ public:
 class wxFilterInputStream : public wxInputStream
 {
 public:
-    //@{
+    ///@{
     /**
         Initializes a "filter" stream.
 
@@ -1029,7 +1029,7 @@ public:
     */
     wxFilterInputStream(wxInputStream& stream);
     wxFilterInputStream(wxInputStream* stream);
-    //@}
+    ///@}
 };
 
 
@@ -1118,7 +1118,7 @@ public:
 class wxWrapperInputStream : public wxFilterInputStream
 {
 public:
-    //@{
+    ///@{
     /**
         Initializes a wrapper stream.
 
@@ -1127,7 +1127,7 @@ public:
     */
     wxWrapperInputStream(wxInputStream& stream);
     wxWrapperInputStream(wxInputStream* stream);
-    //@}
+    ///@}
 
 protected:
     /**
@@ -1139,7 +1139,7 @@ protected:
      */
     wxWrapperInputStream();
 
-    //@{
+    ///@{
     /**
         Set up the wrapped stream for an object initialized using the default
         constructor.
@@ -1150,5 +1150,5 @@ protected:
      */
     void InitParentStream(wxInputStream& stream);
     void InitParentStream(wxInputStream* stream);
-    //@}
+    ///@}
 };

interface/wx/sysopt.h

@@ -173,12 +173,12 @@ public:
     */
     static bool IsFalse(const wxString& name);
 
-    //@{
+    ///@{
     /**
         Sets an option. The function is case-insensitive to @a name.
     */
     static void SetOption(const wxString& name, const wxString& value);
     static void SetOption(const wxString& name, int value);
-    //@}
+    ///@}
 };
 

interface/wx/tarstrm.h

@@ -53,7 +53,7 @@ enum wxTarFormat
 class wxTarInputStream : public wxArchiveInputStream
 {
 public:
-    //@{
+    ///@{
     /**
         Constructor. In a Unicode build the second parameter @a conv is
         used to translate fields from the standard tar header into Unicode.
@@ -68,7 +68,7 @@ public:
                      wxMBConv& conv = wxConvLocal);
     wxTarInputStream(wxInputStream* stream,
                      wxMBConv& conv = wxConvLocal);
-    //@}
+    ///@}
 
     /**
         Closes the current entry.
@@ -133,7 +133,7 @@ public:
 class wxTarOutputStream : public wxArchiveOutputStream
 {
 public:
-    //@{
+    ///@{
     /**
         If the parent stream is passed as a pointer then the new filter stream
         takes ownership of it. If it is passed by reference then it does not.
@@ -159,7 +159,7 @@ public:
     wxTarOutputStream(wxOutputStream* stream,
                       wxTarFormat format = wxTAR_PAX,
                       wxMBConv& conv = wxConvLocal);
-    //@}
+    ///@}
 
     /**
         The destructor calls Close() to finish writing the tar if it has
@@ -202,7 +202,7 @@ public:
     */
     bool CopyEntry(wxTarEntry* entry, wxTarInputStream& inputStream);
 
-    //@{
+    ///@{
     /**
         The tar is zero padded to round its size up to @e BlockingFactor * 512 bytes.
 
@@ -211,7 +211,7 @@ public:
     */
     int GetBlockingFactor() const;
     void SetBlockingFactor(int factor);
-    //@}
+    ///@}
 
     /**
         Create a new directory entry (see wxArchiveEntry::IsDir()) with the given
@@ -271,25 +271,25 @@ public:
     */
     wxTarEntry(const wxTarEntry& entry);
 
-    //@{
+    ///@{
     /**
         Gets/sets the entry's access time stamp.
         See also wxArchiveEntry::GetDateTime() and wxArchiveEntry::SetDateTime().
     */
     wxDateTime GetAccessTime() const;
     void SetAccessTime(const wxDateTime& dt);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The entry's creation time stamp.
         See also wxArchiveEntry::GetDateTime() and wxArchiveEntry::SetDateTime().
     */
     wxDateTime GetCreateTime() const;
     void SetCreateTime(const wxDateTime& dt);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         OS specific IDs defining a device; these are only meaningful when
         wxTarEntry::GetTypeFlag() is @e wxTAR_CHRTYPE or @e wxTAR_BLKTYPE.
@@ -298,9 +298,9 @@ public:
     int GetDevMinor() const;
     void SetDevMajor(int dev);
     void SetDevMinor(int dev);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The user ID and group ID that has permissions (see wxTarEntry::GetMode())
         over this entry.
@@ -313,9 +313,9 @@ public:
     int GetUserId() const;
     void SetGroupId(int id);
     void SetUserId(int id);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The names of the user and group that has permissions (see wxTarEntry::GetMode())
         over this entry. These are not present in very old tars.
@@ -324,9 +324,9 @@ public:
     wxString GetUserName() const;
     void SetGroupName(const wxString& group);
     void SetUserName(const wxString& user);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The filename of a previous entry in the tar that this entry is a link to.
         Only meaningful when wxTarEntry::GetTypeFlag() is set to @e wxTAR_LNKTYPE
@@ -334,9 +334,9 @@ public:
     */
     wxString GetLinkName() const;
     void SetLinkName(const wxString& link);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         UNIX permission bits for this entry.
         Giving read, write and execute permissions to the file's user and group
@@ -346,9 +346,9 @@ public:
     */
     int GetMode() const;
     void SetMode(int mode);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The size of the entry's data in bytes.
 
@@ -362,9 +362,9 @@ public:
     */
     void SetSize(wxFileOffset size);
     wxFileOffset GetSize() const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Returns/Sets the type of the entry as a ::wxTarType value.
 
@@ -375,7 +375,7 @@ public:
     */
     int GetTypeFlag() const;
     void SetTypeFlag(int type);
-    //@}
+    ///@}
 
     /**
         Returns the entry's filename in the internal format used within the archive.

interface/wx/textctrl.h

@@ -277,7 +277,7 @@ enum wxTextCtrlHitTestResult
 class wxTextAttr
 {
 public:
-    //@{
+    ///@{
     /**
         Constructors.
     */
@@ -287,7 +287,7 @@ public:
                const wxFont& font = wxNullFont,
                wxTextAttrAlignment alignment = wxTEXT_ALIGNMENT_DEFAULT);
     wxTextAttr(const wxTextAttr& attr);
-    //@}
+    ///@}
 
     /**
         Applies the attributes in @a style to the original object, but not those
@@ -323,7 +323,7 @@ public:
         @name GetXXX functions
      */
 
-    //@{
+    ///@{
 
     /**
         Returns the alignment flags.
@@ -532,7 +532,7 @@ public:
     */
     const wxString& GetURL() const;
 
-    //@}
+    ///@}
 
 
 
@@ -540,7 +540,7 @@ public:
         @name HasXXX and IsXXX functions
      */
 
-    //@{
+    ///@{
 
     /**
         Returns @true if the attribute object specifies alignment.
@@ -720,14 +720,14 @@ public:
     */
     bool IsParagraphStyle() const;
 
-    //@}
+    ///@}
 
 
     /**
         @name SetXXX functions
      */
 
-    //@{
+    ///@{
 
     /**
         Sets the paragraph alignment. See ::wxTextAttrAlignment enumeration values.
@@ -969,7 +969,7 @@ public:
     */
     void SetURL(const wxString& url);
 
-    //@}
+    ///@}
 
 
     /**
@@ -1764,7 +1764,7 @@ public:
     /**
         @name Mac-specific functions
     */
-    //@{
+    ///@{
 
     /**
         Enable the automatic replacement of new lines characters in a
@@ -1788,9 +1788,9 @@ public:
     */
     void OSXEnableNewLineReplacement(bool enable);
 
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Operator definitions for appending to a text control.
 
@@ -1810,7 +1810,7 @@ public:
     wxTextCtrl& operator<<(double d);
     wxTextCtrl& operator<<(char c);
     wxTextCtrl& operator<<(wchar_t c);
-    //@}
+    ///@}
 };
 
 

interface/wx/textdlg.h

@@ -154,10 +154,10 @@ public:
         custom class derived from wxTextValidator while the second one creates
         a wxTextValidator with the specified @a style.
      */
-    //@{
+    ///@{
     void SetTextValidator(const wxTextValidator& validator);
     void SetTextValidator(wxTextValidatorStyle style = wxFILTER_NONE);
-    //@}
+    ///@}
 
     /**
         This function sets the maximum number of characters the user can enter

interface/wx/textentry.h

@@ -497,7 +497,7 @@ public:
      */
     virtual wxString GetHint() const;
 
-    //@{
+    ///@{
     /**
         Attempts to set the control margins. When margins are given as wxPoint,
         x indicates the left and y the top margin. Use -1 to indicate that
@@ -510,7 +510,7 @@ public:
     */
     bool SetMargins(const wxPoint& pt);
     bool SetMargins(wxCoord left, wxCoord top = -1);
-    //@}
+    ///@}
 
     /**
         Returns the margins used by the control. The @c x field of the returned

interface/wx/textfile.h

@@ -193,10 +193,10 @@ public:
         shouldn't add line terminator at the end -- this will be done by
         wxTextFile itself.
     */
-    //@{
+    ///@{
     wxString& GetLine(size_t n);
     const wxString& GetLine(size_t n) const;
-    //@}
+    ///@}
 
     /**
         Get the number of lines in the file.

interface/wx/toolbar.h

@@ -408,7 +408,7 @@ public:
      */
     wxToolBarToolBase *AddStretchableSpace();
 
-    //@{
+    ///@{
     /**
         Adds a tool to the toolbar.
 
@@ -504,7 +504,7 @@ public:
                                const wxString& shortHelp = wxEmptyString,
                                const wxString& longHelp = wxEmptyString,
                                wxObject* clientData = NULL);
-    //@}
+    ///@}
 
     /**
         Deletes all the tools in the toolbar.
@@ -732,7 +732,7 @@ public:
      */
     wxToolBarToolBase *InsertStretchableSpace(size_t pos);
 
-    //@{
+    ///@{
     /**
         Inserts the tool with the specified attributes into the toolbar at the
         given position.
@@ -757,7 +757,7 @@ public:
 
     wxToolBarToolBase* InsertTool(size_t pos,
                                   wxToolBarToolBase* tool);
-    //@}
+    ///@}
 
     /**
         Called when the user clicks on a tool with the left mouse button. This
@@ -845,7 +845,7 @@ public:
     */
     bool SetDropdownMenu(int id, wxMenu* menu);
 
-    //@{
+    ///@{
     /**
         Set the values to be used as margins for the toolbar.
 
@@ -875,7 +875,7 @@ public:
         @see GetMargins(), wxSize
     */
     void SetMargins(const wxSize& size);
-    //@}
+    ///@}
 
     /**
         Sets the default size of each tool bitmap.

interface/wx/toolbook.h

@@ -58,7 +58,7 @@ wxEventType wxEVT_TOOLBOOK_PAGE_CHANGING;
 class wxToolbook : public wxBookCtrlBase
 {
 public:
-    //@{
+    ///@{
     /**
         Constructs a choicebook control.
     */
@@ -68,7 +68,7 @@ public:
                  const wxSize& size = wxDefaultSize,
                  long style = 0,
                  const wxString& name = wxEmptyString);
-    //@}
+    ///@}
 
     /**
        Create the tool book control that has already been constructed with

interface/wx/treelist.h

@@ -321,7 +321,7 @@ public:
         containing them first and then specify the indices of the icons in this
         image list when adding the items later.
      */
-    //@{
+    ///@{
 
     /// A constant indicating that no image should be used for an item.
     static const int NO_IMAGE = -1;
@@ -348,13 +348,13 @@ public:
     */
     void SetImageList(wxImageList* imageList);
 
-    //@}
+    ///@}
 
 
     /**
         @name Column methods.
      */
-    //@{
+    ///@{
 
     /**
         Add a column with the given title and attributes.
@@ -424,7 +424,7 @@ public:
      */
     int WidthFor(const wxString& text) const;
 
-    //@}
+    ///@}
 
 
     /**
@@ -442,7 +442,7 @@ public:
         (either by an explicit DeleteItem() call or because the entire control
         is destroyed).
      */
-    //@{
+    ///@{
 
     /// Same as InsertItem() with wxTLI_LAST.
     wxTreeListItem AppendItem(wxTreeListItem parent,
@@ -493,7 +493,7 @@ public:
     /// Delete all tree items.
     void DeleteAllItems();
 
-    //@}
+    ///@}
 
 
     /**
@@ -507,7 +507,7 @@ public:
         by using GetFirstChild() to get the first of them and then calling
         GetNextSibling() to retrieve all the others.
      */
-    //@{
+    ///@{
 
     /// Return the (never shown) root item.
     wxTreeListItem GetRootItem() const;
@@ -563,13 +563,13 @@ public:
      */
     wxTreeListItem GetNextItem(wxTreeListItem item) const;
 
-    //@}
+    ///@}
 
 
     /**
         @name Items attributes
      */
-    //@{
+    ///@{
 
     /**
         Return the text of the given item.
@@ -615,7 +615,7 @@ public:
      */
     void SetItemData(wxTreeListItem item, wxClientData* data);
 
-    //@}
+    ///@}
 
 
     /**
@@ -624,7 +624,7 @@ public:
         Notice that calling neither Expand() nor Collapse() method generates
         any events.
      */
-    //@{
+    ///@{
 
     /**
         Expand the given tree branch.
@@ -641,7 +641,7 @@ public:
      */
     bool IsExpanded(wxTreeListItem item) const;
 
-    //@}
+    ///@}
 
 
     /**
@@ -652,7 +652,7 @@ public:
         when creating it). Not all methods can be used in both modes and some
         of those that can don't behave in the same way in two cases.
      */
-    //@{
+    ///@{
 
     /**
         Return the currently selected item.
@@ -720,7 +720,7 @@ public:
      */
     void EnsureVisible(wxTreeListItem item);
 
-    //@}
+    ///@}
 
 
     /**
@@ -729,7 +729,7 @@ public:
         Methods in this section can only be used with the controls created with
         wxTL_CHECKBOX style.
      */
-    //@{
+    ///@{
 
     /**
         Change the item checked state.
@@ -799,7 +799,7 @@ public:
     bool AreAllChildrenInState(wxTreeListItem item,
                                wxCheckBoxState state) const;
 
-    //@}
+    ///@}
 
     /**
         @name Sorting.
@@ -814,7 +814,7 @@ public:
         and call GetSortColumn() to determine whether it's sorted now and, if
         so, by which column and in which order.
      */
-    //@{
+    ///@{
 
     /**
         Set the column to use for sorting and the order in which to sort.
@@ -863,7 +863,7 @@ public:
      */
     void SetItemComparator(wxTreeListItemComparator* comparator);
 
-    //@}
+    ///@}
 
 
     /**
@@ -875,7 +875,7 @@ public:
         wxDataViewCtrl-based, use GetView() function only and only use
         GetDataView() if you really need to call wxDataViewCtrl methods on it.
      */
-    //@{
+    ///@{
 
     /**
         Return the view part of this control as a wxWindow.
@@ -894,7 +894,7 @@ public:
      */
     wxDataViewCtrl* GetDataView() const;
 
-    //@}
+    ///@}
 };
 
 

interface/wx/unichar.h

@@ -29,14 +29,14 @@ public:
     */
     wxUniChar();
 
-    //@{
+    ///@{
     /**
         Create a character from the 8-bit character value @a c using the
         current locale encoding.
     */
     wxUniChar(char c);
     wxUniChar(unsigned char c);
-    //@}
+    ///@}
 
     wxUniChar(int c);
     wxUniChar(unsigned int c);
@@ -159,7 +159,7 @@ public:
     */
     static wxUint16 LowSurrogate(wxUint32 value);
 
-    //@{
+    ///@{
     /**
         Conversions to char and wchar_t types: all of those are needed to be
         able to pass wxUniChars to various standard narrow and wide character
@@ -176,9 +176,9 @@ public:
     operator unsigned short int() const;
     operator wxLongLong_t() const;
     operator wxULongLong_t() const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Assignment operators
     */
@@ -195,7 +195,7 @@ public:
     wxUniChar& operator=(unsigned short int c);
     wxUniChar& operator=(wxLongLong_t c);
     wxUniChar& operator=(wxULongLong_t c);
-    //@}
+    ///@}
 };
 
 

interface/wx/variant.h

@@ -265,7 +265,7 @@ public:
     /**
         @name List Functionality
     */
-    //@{
+    ///@{
 
     /**
         Returns the value at @a idx (zero-based).
@@ -321,10 +321,10 @@ public:
     */
     void NullList();
 
-    //@}
+    ///@}
 
 
-    //@{
+    ///@{
     /**
         Retrieves and converts the value of this variant to the type that
         @a value is.
@@ -337,7 +337,7 @@ public:
     bool Convert(wxLongLong* value) const;
     bool Convert(wxULongLong* value) const;
     bool Convert(wxDateTime* value) const;
-    //@}
+    ///@}
 
     /**
         Converts wxVariant into wxAny.
@@ -482,7 +482,7 @@ public:
     */
     bool Unshare();
 
-    //@{
+    ///@{
     /**
         Inequality test operator.
     */
@@ -500,9 +500,9 @@ public:
     bool operator !=(const wxVariantList& value) const;
     bool operator !=(const wxArrayString& value) const;
     bool operator !=(const wxDateTime& value) const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Assignment operator, using @ref overview_refcount "reference counting"
         if possible.
@@ -522,9 +522,9 @@ public:
     void operator =(const wxVariantList& value);
     void operator =(const wxDateTime& value);
     void operator =(const wxArrayString& value);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Equality test operator.
     */
@@ -542,9 +542,9 @@ public:
     bool operator ==(const wxVariantList& value) const;
     bool operator ==(const wxArrayString& value) const;
     bool operator ==(const wxDateTime& value) const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Operators for implicit conversion, using appropriate getter member
         function.
@@ -553,7 +553,7 @@ public:
     long operator long() const;
     wxLongLong operator wxLongLong() const;
     wxULongLong operator wxULongLong() const;
-    //@}
+    ///@}
 
     /**
         Operator for implicit conversion to a pointer to a void, using

interface/wx/vector.h

@@ -257,10 +257,10 @@ public:
         either the copies of the given object @a v or @c value_type() objects
         until it becomes of size @a n.
      */
-    //@{
+    ///@{
     void resize(size_type n);
     void resize(size_type n, const value_type& v);
-    //@}
+    ///@}
 
     /**
         Free unused memory allocated by the vector.

interface/wx/vlbox.h

@@ -233,7 +233,7 @@ public:
     */
     virtual void SetItemCount(size_t count);
 
-    //@{
+    ///@{
     /**
         Set the margins: horizontal margin is the distance between the window
         border and the item contents while vertical margin is half of the
@@ -243,7 +243,7 @@ public:
     */
     void SetMargins(const wxPoint& pt);
     void SetMargins(wxCoord x, wxCoord y);
-    //@}
+    ///@}
 
     /**
         Set the selection to the specified item, if it is -1 the selection is

interface/wx/vscroll.h

@@ -539,25 +539,25 @@ public:
     */
     wxPosition GetVisibleEnd() const;
 
-    //@{
+    ///@{
     /**
         Returns @true if both the given row and column are currently visible
         (even if only partially visible) or @false otherwise.
     */
     bool IsVisible(size_t row, size_t column) const;
     bool IsVisible(const wxPosition& pos) const;
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Triggers a refresh for just the area shared between the given row and
         column of the window if it is visible.
     */
     virtual void RefreshRowColumn(size_t row, size_t column);
     virtual void RefreshRowColumn(const wxPosition& pos);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Triggers a refresh for the visible area shared between all given rows
         and columns (inclusive) of the window. If the target window for both
@@ -569,9 +569,9 @@ public:
                                     size_t fromColumn, size_t toColumn);
     virtual void RefreshRowsColumns(const wxPosition& from,
                                     const wxPosition& to);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Scroll to the specified row and column. It will become the first
         visible row and column in the window. Returns @true if we scrolled the
@@ -579,7 +579,7 @@ public:
     */
     bool ScrollToRowColumn(size_t row, size_t column);
     bool ScrollToRowColumn(const wxPosition& pos);
-    //@}
+    ///@}
 
     /**
         Set the number of rows and columns the target window will contain. The
@@ -591,7 +591,7 @@ public:
     */
     void SetRowColumnCount(size_t rowCount, size_t columnCount);
 
-    //@{
+    ///@{
     /**
         Returns the virtual scroll unit under the device unit given accounting
         for scroll position or @c wxNOT_FOUND (for the row, column, or possibly
@@ -599,7 +599,7 @@ public:
     */
     wxPosition VirtualHitTest(wxCoord x, wxCoord y) const;
     wxPosition VirtualHitTest(const wxPoint& pos) const;
-    //@}
+    ///@}
 };
 
 

interface/wx/zipstrm.h

@@ -193,15 +193,15 @@ public:
     */
     wxZipEntry* Clone() const;
 
-    //@{
+    ///@{
     /**
         Gets and sets the short comment for this entry.
     */
     wxString GetComment() const;
     void SetComment(const wxString& comment);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The low 8 bits are always the DOS/Windows file attributes for this entry.
         The values of these attributes are given in the enumeration ::wxZipAttributes.
@@ -217,9 +217,9 @@ public:
     */
     wxUint32 GetExternalAttributes() const;
     void SetExternalAttributes(wxUint32 attr);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The extra field from the entry's central directory record.
 
@@ -229,9 +229,9 @@ public:
     const char* GetExtra() const;
     size_t GetExtraLen() const;
     void SetExtra(const char* extra, size_t len);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The extra field from the entry's local record.
 
@@ -241,9 +241,9 @@ public:
     const char* GetLocalExtra() const;
     size_t GetLocalExtraLen() const;
     void SetLocalExtra(const char* extra, size_t len);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The compression method.
         The enumeration ::wxZipMethod lists the possible values.
@@ -253,9 +253,9 @@ public:
     */
     int GetMethod() const;
     void SetMethod(int method);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         If IsMadeByUnix() is true then returns the unix permission bits stored
         in GetExternalAttributes(). Otherwise synthesises them from the DOS attributes.
@@ -272,9 +272,9 @@ public:
         permissions when creating zips, call SetSystemMadeBy(wxZIP_SYSTEM_UNIX).
     */
     void SetMode(int mode);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         The originating file-system.
 
@@ -284,7 +284,7 @@ public:
     */
     int GetSystemMadeBy() const;
     void SetSystemMadeBy(int system);
-    //@}
+    ///@}
 
     /**
         The compressed size of this entry in bytes.
@@ -326,15 +326,15 @@ public:
     */
     bool IsMadeByUnix() const;
 
-    //@{
+    ///@{
     /**
         Indicates that this entry's data is text in an 8-bit encoding.
     */
     bool IsText() const;
     void SetIsText(bool isText = true);
-    //@}
+    ///@}
 
-    //@{
+    ///@{
     /**
         Sets the notifier (see wxZipNotifier) for this entry.
         Whenever the wxZipInputStream updates this entry, it will then invoke
@@ -348,7 +348,7 @@ public:
     */
     void SetNotifier(wxZipNotifier& notifier);
     void UnsetNotifier();
-    //@}
+    ///@}
 
     /**
         Assignment operator.
@@ -381,7 +381,7 @@ class wxZipInputStream : public wxArchiveInputStream
 {
 public:
 
-    //@{
+    ///@{
     /**
         Constructor. In a Unicode build the second parameter @a conv is used to
         translate the filename and comment fields into Unicode.
@@ -393,7 +393,7 @@ public:
                      wxMBConv& conv = wxConvLocal);
     wxZipInputStream(wxInputStream* stream,
                      wxMBConv& conv = wxConvLocal);
-    //@}
+    ///@}
 
     /**
         Closes the current entry.
@@ -477,7 +477,7 @@ public:
 class wxZipOutputStream : public wxArchiveOutputStream
 {
 public:
-    //@{
+    ///@{
     /**
         Constructor.
 
@@ -502,7 +502,7 @@ public:
                       wxMBConv& conv = wxConvUTF8);
     wxZipOutputStream(wxOutputStream* stream, int level = -1,
                       wxMBConv& conv = wxConvUTF8);
-    //@}
+    ///@}
 
     /**
         The destructor calls Close() to finish writing the zip if it has
@@ -544,7 +544,7 @@ public:
     */
     bool CopyEntry(wxZipEntry* entry, wxZipInputStream& inputStream);
 
-    //@{
+    ///@{
     /**
         Set the compression level that will be used the next time an entry is
         created.
@@ -554,7 +554,7 @@ public:
     */
     int GetLevel() const;
     void SetLevel(int level);
-    //@}
+    ///@}
 
     /**
         Create a new directory entry (see wxArchiveEntry::IsDir) with the given
@@ -566,7 +566,7 @@ public:
     bool PutNextDirEntry(const wxString& name,
                          const wxDateTime& dt = wxDateTime::Now());
 
-    //@{
+    ///@{
     /**
         Takes ownership of @a entry and uses it to create a new entry in the zip.
 
@@ -584,7 +584,7 @@ public:
     bool PutNextEntry(const wxString& name,
                       const wxDateTime& dt = wxDateTime::Now(),
                       wxFileOffset size = wxInvalidOffset);
-    //@}
+    ///@}
 
     /**
         Sets a comment for the zip as a whole.

interface/wx/zstream.h

@@ -43,7 +43,7 @@ enum wxZLibFlags {
 class wxZlibOutputStream : public wxFilterOutputStream
 {
 public:
-    //@{
+    ///@{
     /**
         Creates a new write-only compressed stream.
 
@@ -69,14 +69,14 @@ public:
                        int flags = wxZLIB_ZLIB);
     wxZlibOutputStream(wxOutputStream* stream, int level = -1,
                        int flags = wxZLIB_ZLIB);
-    //@}
+    ///@}
 
     /**
         Returns @true if zlib library in use can handle gzip compressed data.
     */
     static bool CanHandleGZip();
 
-    //@{
+    ///@{
     /**
         Sets the dictionary to the specified chunk of data. This can improve
         compression rate but note that the dictionary has to be the same when
@@ -87,7 +87,7 @@ public:
     */
     bool SetDictionary(const char *data, size_t datalen);
     bool SetDictionary(const wxMemoryBuffer &buf);
-    //@}
+    ///@}
 };
 
 
@@ -110,7 +110,7 @@ public:
 class wxZlibInputStream : public wxFilterInputStream
 {
 public:
-    //@{
+    ///@{
     /**
         If the parent stream is passed as a pointer then the new filter stream
         takes ownership of it. If it is passed by reference then it does not.
@@ -128,14 +128,14 @@ public:
     */
     wxZlibInputStream(wxInputStream& stream, int flags = wxZLIB_AUTO);
     wxZlibInputStream(wxInputStream* stream, int flags = wxZLIB_AUTO);
-    //@}
+    ///@}
 
     /**
         Returns @true if zlib library in use can handle gzip compressed data.
     */
     static bool CanHandleGZip();
 
-    //@{
+    ///@{
     /**
         Sets the dictionary to the specified chunk of data. This can improve
         compression rate but note that the dictionary has to be the same when
@@ -146,6 +146,6 @@ public:
     */
     bool SetDictionary(const char *data, size_t datalen);
     bool SetDictionary(const wxMemoryBuffer &buf);
-    //@}
+    ///@}
 };
 

src/stc/stc.interface.h.in

@@ -88,7 +88,7 @@ public:
     // Ctor, etc
     // ----------------------------------------------
     ///@member_group_name{ctor, Constructors and related methods}
-    //@{
+    ///@{
 
     /**
         Ctor.
@@ -115,7 +115,7 @@ public:
                 const wxSize& size = wxDefaultSize, long style = 0,
                 const wxString& name = wxSTCNameStr);
 
-    //@}
+    ///@}
 
 
     // Scintilla methods (generated by gen_iface.py)
@@ -136,7 +136,7 @@ public:
         In addition to the standard Scintilla functions, wxStyledTextCtrl
         includes the following functions to simplify some tasks.
     */
-    //@{
+    ///@{
 
     /**
        Returns the line number of the line with the caret.
@@ -286,7 +286,7 @@ public:
     */
     void RegisterImage(int type, const wxBitmap& bmp);
 
-    //@}
+    ///@}
 
 
     // Raw versions
@@ -297,7 +297,7 @@ public:
         These methods allow data to be sent to or received from the control
         using character buffers instead of using a wxString.
     */
-    //@{
+    ///@{
 
     /**
        Add text to the document at current position.
@@ -398,13 +398,13 @@ public:
     */
     int ReplaceTargetRERaw(const char* text, int length=-1);
 
-    //@}
+    ///@}
 
 
     // wxTextEntryBase pure virtual methods
     // ----------------------------------------------
     ///@member_group_name{text_entry, Text entry methods}
-    //@{
+    ///@{
 
     /**
         Writes the text into the text control at the current insertion position.
@@ -567,13 +567,13 @@ public:
     */
     virtual void SetEditable(bool editable);
 
-    //@}
+    ///@}
 
 
     // wxTextAreaBase pure virtual methods
     // ---------------------------------------------
     ///@member_group_name{text_area, Text area methods}
-    //@{
+    ///@{
 
     /**
         Gets the length of the specified line, not including any trailing
@@ -754,7 +754,7 @@ public:
     virtual wxTextCtrlHitTestResult HitTest(const wxPoint& pt,
                                             wxTextCoord *col,
                                             wxTextCoord *row) const;
-    //@}
+    ///@}
 
 
     // VersionInfo