Make storing non-trivial data in wxThreadSpecificInfo possible.

[wxWidgets.git] / interface / wx / fontdlg.h

diff --git a/interface/wx/fontdlg.h b/interface/wx/fontdlg.h
index 4a5ea24021eecf3065ae67b417724ab51cd6a0ef..88fc7e414a6a02bda0be38a39c782a60abe7ec96 100644 (file)
--- a/interface/wx/fontdlg.h
+++ b/interface/wx/fontdlg.h
@@ -2,62 +2,74 @@
 // Name:        fontdlg.h
 // Purpose:     interface of wxFontDialog
 // Author:      wxWidgets team
-// RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
     @class wxFontDialog
-    @wxheader{fontdlg.h}
 
     This class represents the font chooser dialog.
 
     @library{wxcore}
     @category{cmndlg}
 
-    @see Overview(), wxFontData, wxGetFontFromUser()
+    @see overview_cmndlg_font, wxFontData, wxGetFontFromUser()
 */
 class wxFontDialog : public wxDialog
 {
 public:
-    //@{
     /**
-        Constructor. Pass a parent window, and optionally the
-        @ref overview_wxfontdata "font data" object to be used to initialize the dialog
-        controls. If the default constructor is used,
-        Create() must be called before the dialog can be
-        shown.
+        Default ctor.
+        Create() must be called before the dialog can be shown.
     */
     wxFontDialog();
+
+    /**
+        Constructor with parent window.
+    */
     wxFontDialog(wxWindow* parent);
+
+    /**
+        Constructor.
+        Pass a parent window, and the @ref wxFontData "font data" object
+        to be used to initialize the dialog controls.
+    */
     wxFontDialog(wxWindow* parent, const wxFontData& data);
-    //@}
 
-    //@{
     /**
-        Creates the dialog if it the wxFontDialog object had been initialized using the
-        default constructor. Returns @true on success and @false if an error
-        occurred.
+        Creates the dialog if the wxFontDialog object had been initialized using
+        the default constructor.
+
+        @return @true on success and @false if an error occurred.
     */
     bool Create(wxWindow* parent);
+
+    /**
+        Creates the dialog if the wxFontDialog object had been initialized using
+        the default constructor.
+
+        @return @true on success and @false if an error occurred.
+    */
     bool Create(wxWindow* parent, const wxFontData& data);
-    //@}
 
     //@{
     /**
-        Returns the @ref overview_wxfontdata "font data" associated with the font
-        dialog.
+        Returns the @ref wxFontData "font data" associated with the
+        font dialog.
     */
-    const wxFontData GetFontData();
-    const wxFontData&  GetFontData();
+    const wxFontData& GetFontData() const;
+    wxFontData& GetFontData();
     //@}
 
     /**
         Shows the dialog, returning @c wxID_OK if the user pressed Ok, and
         @c wxID_CANCEL otherwise.
+
         If the user cancels the dialog (ShowModal returns @c wxID_CANCEL), no font
         will be created. If the user presses OK, a new wxFont will be created and
         stored in the font dialog's wxFontData structure.
+
+        @see GetFontData()
     */
     int ShowModal();
 };
@@ -68,7 +80,7 @@ public:
 // Global functions/macros
 // ============================================================================
 
-/** @ingroup group_funcmacro_dialog */
+/** @addtogroup group_funcmacro_dialog */
 //@{
 
 /**