Fix typo in wxStandardPathsBase::ResourceCat description and document it.

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

diff --git a/interface/wx/fontdlg.h b/interface/wx/fontdlg.h
index 8afae325e897db4124903248a365d77b84d91b36..bd0d404ce63aedf2b5285e44f3f0132dbb3a2956 100644 (file)
--- a/interface/wx/fontdlg.h
+++ b/interface/wx/fontdlg.h
@@ -3,7 +3,7 @@
 // Purpose:     interface of wxFontDialog
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
@@ -14,49 +14,63 @@
     @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();
 };
@@ -67,7 +81,7 @@ public:
 // Global functions/macros
 // ============================================================================
 
-/** @ingroup group_funcmacro_dialog */
+/** @addtogroup group_funcmacro_dialog */
 //@{
 
 /**