Try out - instead of @li, more backslash escaping

[wxWidgets.git] / interface / textdlg.h

diff --git a/interface/textdlg.h b/interface/textdlg.h
index 441d07f4d3fec74584fdcef4f7f93e16b99c8d00..dc7245790d846aa9b40d049d6ec363b2b9c5d837 100644 (file)
--- a/interface/textdlg.h
+++ b/interface/textdlg.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        textdlg.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        textdlg.h

-// Purpose:     documentation for wxPasswordEntryDialog class
+// Purpose:     interface of wxPasswordEntryDialog

 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license


@@ -17,8 +17,8 @@
     @library{wxbase}
     @category{cmndlg}
 
     @library{wxbase}
     @category{cmndlg}
 

-    @seealso
-    @ref overview_wxpasswordentrydialogoverview "wxPassowrdEntryDialog overview"
+    @see @ref overview_wxpasswordentrydialogoverview "wxPassowrdEntryDialog
+    overview"

 */
 class wxPasswordEntryDialog : public wxTextEntryDialog
 {
 */
 class wxPasswordEntryDialog : public wxTextEntryDialog
 {


@@ -27,6 +27,7 @@ public:
 };
 
 
 };
 
 

+

 /**
     @class wxTextEntryDialog
     @wxheader{textdlg.h}
 /**
     @class wxTextEntryDialog
     @wxheader{textdlg.h}


@@ -38,36 +39,31 @@ public:
     @library{wxbase}
     @category{cmndlg}
 
     @library{wxbase}
     @category{cmndlg}
 

-    @seealso
-    @ref overview_wxtextentrydialogoverview "wxTextEntryDialog overview"
+    @see @ref overview_wxtextentrydialogoverview "wxTextEntryDialog overview"

 */
 class wxTextEntryDialog : public wxDialog
 {
 public:
     /**
         Constructor. Use ShowModal() to show the dialog.
 */
 class wxTextEntryDialog : public wxDialog
 {
 public:
     /**
         Constructor. Use ShowModal() to show the dialog.

-        
+

         @param parent
         @param parent

-        Parent window.
-        
+            Parent window.

         @param message
         @param message

-        Message to show on the dialog.
-        
+            Message to show on the dialog.

         @param defaultValue
         @param defaultValue

-        The default value, which may be the empty string.
-        
+            The default value, which may be the empty string.

         @param style
         @param style

-        A dialog style, specifying the buttons (wxOK, wxCANCEL)
-        and an optional wxCENTRE style. Additionally, wxTextCtrl styles (such as
-        wxTE_PASSWORD) may be specified here.
-        
+            A dialog style, specifying the buttons (wxOK, wxCANCEL)
+            and an optional wxCENTRE style. Additionally, wxTextCtrl styles (such as
+            wxTE_PASSWORD) may be specified here.

         @param pos
         @param pos

-        Dialog position.
+            Dialog position.

     */
     wxTextEntryDialog(wxWindow* parent, const wxString& message,
                       const wxString& caption = "Please enter text",
                       const wxString& defaultValue = "",
     */
     wxTextEntryDialog(wxWindow* parent, const wxString& message,
                       const wxString& caption = "Please enter text",
                       const wxString& defaultValue = "",

-                      long style = wxOK |  wxCANCEL |  wxCENTRE,
+                      long style = wxOK | wxCANCEL | wxCENTRE,

                       const wxPoint& pos = wxDefaultPosition);
 
     /**
                       const wxPoint& pos = wxDefaultPosition);
 
     /**


@@ -80,7 +76,7 @@ public:
         original value
         if the user has pressed Cancel.
     */
         original value
         if the user has pressed Cancel.
     */

-    wxString GetValue();
+    wxString GetValue() const;

 
     /**
         Sets the default text value.
 
     /**
         Sets the default text value.


@@ -95,36 +91,46 @@ public:
 };
 
 
 };
 
 

+

 // ============================================================================
 // Global functions/macros
 // ============================================================================
 
 // ============================================================================
 // Global functions/macros
 // ============================================================================
 

+/** @ingroup group_funcmacro_dialog */
+//@{
+

 /**
 /**

-    Pop up a dialog box with title set to @e caption, @e message, and a
-    @e default_value.  The user may type in text and press OK to return this text,
-    or press Cancel to return the empty string.
+    Pop up a dialog box with title set to @e caption, @c message, and a
+    @c default_value. The user may type in text and press OK to return this
+    text, or press Cancel to return the empty string.

 
 

-    If @e centre is @true, the message text (which may include new line characters)
-    is centred; if @false, the message is left-justified.
+    If @c centre is @true, the message text (which may include new line
+    characters) is centred; if @false, the message is left-justified.
+
+    @header{wx/textdlg.h}

 */
 wxString wxGetTextFromUser(const wxString& message,
                            const wxString& caption = "Input text",
                            const wxString& default_value = "",
 */
 wxString wxGetTextFromUser(const wxString& message,
                            const wxString& caption = "Input text",
                            const wxString& default_value = "",

-                           wxWindow * parent = @NULL,
+                           wxWindow* parent = NULL,

                            int x = wxDefaultCoord,
                            int y = wxDefaultCoord,
                            int x = wxDefaultCoord,
                            int y = wxDefaultCoord,

-                           bool centre = @true);
+                           bool centre = true);

 
 /**
 
 /**

-    Similar to wxGetTextFromUser but the text entered
-    in the dialog is not shown on screen but replaced with stars. This is intended
-    to be used for entering passwords as the function name implies.
+    Similar to wxGetTextFromUser() but the text entered in the dialog is not
+    shown on screen but replaced with stars. This is intended to be used for
+    entering passwords as the function name implies.
+
+    @header{wx/textdlg.h}

 */
 wxString wxGetPasswordFromUser(const wxString& message,
                                const wxString& caption = "Input text",
                                const wxString& default_value = "",
 */
 wxString wxGetPasswordFromUser(const wxString& message,
                                const wxString& caption = "Input text",
                                const wxString& default_value = "",

-                               wxWindow * parent = @NULL,
+                               wxWindow* parent = NULL,

                                int x = wxDefaultCoord,
                                int y = wxDefaultCoord,
                                int x = wxDefaultCoord,
                                int y = wxDefaultCoord,

-                               bool centre = @true);
+                               bool centre = true);
+
+//@}