2 files changed, 7 insertions, 8 deletions

diff --git a/libopie2/opiesecurity/multiauthpassword.cpp b/libopie2/opiesecurity/multiauthpassword.cpp
index b793717..42341f7 100644
--- a/libopie2/opiesecurity/multiauthpassword.cpp
+++ b/libopie2/opiesecurity/multiauthpassword.cpp
@@ -76,8 +76,7 @@ bool MultiauthPassword::needToAuthenticate(bool at_poweron)
  * This method will check if you require authentication
- * and then will lock the screen and require a succesfull
- * authentication.
- * Authenticate may enter the event loop and only returns
- * if the user sucesfully authenticated to the system.
- *
- * @return only if succesfully authenticated
+ * and then will lock the screen and ask for a successful
+ * authentication (explaining what it does or not, depending
+ * on your local configuration).
+ * It may go into an event loop, but anyhow it will only end
+ * when the user has successfully authenticated to the system.
  */
diff --git a/libopie2/opiesecurity/multiauthpassword.h b/libopie2/opiesecurity/multiauthpassword.h
index f43934d..fe276da 100644
--- a/libopie2/opiesecurity/multiauthpassword.h
+++ b/libopie2/opiesecurity/multiauthpassword.h
@@ -41,3 +41,3 @@ namespace Security {
 /**
- * This is the dropin replacement for libqpes Password class.
+ * This is the dropin replacement for the libqpe Password class.
  * If you call authenticate() a widget will cover the whole screen
@@ -45,3 +45,3 @@ namespace Security {
  * configured Authentication Plugins.
- * This uses the \sa Opie::Security::MultiauthMainWindow internally.
+ * It uses the Opie::Security::MultiauthMainWindow QDialog internally.
  *