Doxygen documentation: more paranoid fixes and complements in common dialogs. Added new test cases in the ask demo now featuring fl_message() and fl_password() API, made fl_choice() more specific about its return value tests in caller (also added a third button).

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6369 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 2 insertions, 2 deletions

diff --git a/src/fl_ask.cxx b/src/fl_ask.cxx
index ef4b84cfa..f57462673 100644
--- a/src/fl_ask.cxx
+++ b/src/fl_ask.cxx
@@ -379,7 +379,7 @@ static const char* input_innards(const char* fmt, va_list ap,
 /** Shows an input dialog displaying the \a fmt message
    \param[in] fmt can be used as an sprintf-like format and variables for the message text
    \param[in] defstr defines the default returned string if no text is entered
-   \return the user string input
+   \return the user string input if OK was pushed, NULL if Cancel was pushed
  */
 const char* fl_input(const char *fmt, const char *defstr, ...) {
   fl_beep(FL_BEEP_QUESTION);
@@ -396,7 +396,7 @@ const char* fl_input(const char *fmt, const char *defstr, ...) {
     '*' characters are displayed instead
    \param[in] fmt can be used as an sprintf-like format and variables for the message text
    \param[in] defstr defines the default returned string if no text is entered
-   \return the user string input
+   \return the user string input if OK was pushed, NULL if Cancel was pushed
  */
 const char *fl_password(const char *fmt, const char *defstr, ...) {
   fl_beep(FL_BEEP_PASSWORD);