Next camel

[lyx.git] / src / frontends / alert.h

diff --git a/src/frontends/alert.h b/src/frontends/alert.h
index 004a17988578e52b04118e91dcfb25ed32883a41..433369d1b9bdecd73ee0e9bdd4837182ae59839f 100644 (file)
--- a/src/frontends/alert.h
+++ b/src/frontends/alert.h
@@ -37,8 +37,11 @@ int prompt(docstring const & title, docstring const & question,
 /**
  * Display a warning to the user. Title should be a short (general) summary.
  * Only use this if the user cannot perform some remedial action.
+ * \p askshowagain will display a check box where the user can turn off the
+ * warning for future cases. Ponder carefully if this is feasible.
  */
-void warning(docstring const & title, docstring const & message);
+void warning(docstring const & title, docstring const & message,
+            bool const & askshowagain = false);
 
 /**
  * Display a warning to the user. Title should be a short (general) summary.
@@ -54,7 +57,10 @@ void error(docstring const & title, docstring const & message);
  */
 void information(docstring const & title, docstring const & message);
 
-/// Asks for a text. DO NOT USE !!
+/**
+ * Asks for a text. Returns true for OK. Obtained message is in response
+ * (even empty string). dflt stands for default message in the dialog.
+ */
 bool askForText(docstring & response, docstring const & msg,
        docstring const & dflt = docstring());