1 files changed, 5 insertions, 6 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
@@ -53,54 +53,53 @@ namespace Security {
 
 
 /**
  * If the users requires authentication... #fixme
  *
  * @todo fix up at_poweron attribute
  */
 bool MultiauthPassword::needToAuthenticate(bool at_poweron)
 {
     Config cfg("Security");
     cfg.setGroup("Misc");
     if ( !at_poweron && cfg.readBoolEntry("onStart", false) )
         return true;
     else if ( at_poweron && cfg.readBoolEntry("onResume", false) )
         return true;
     else
         return false;
 }
 
 
 /**
  * \brief Require user authentication to unlock and continue
  *
  * 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.
  */
 void MultiauthPassword::authenticate(bool at_poweron)
 {
     if ( ! needToAuthenticate(at_poweron) )
         return;
 
     /* Constructs the main window, which displays messages and blocks
      * access to the desktop
      */
     MultiauthMainWindow win;
 
     // resize the QDialog object so it fills all the screen
     QRect desk = qApp->desktop()->geometry();
     win.setGeometry( 0, 0, desk.width(), desk.height() );
 
     // the authentication has already succeeded (without win interactions)
     if ( win.isAlreadyDone() )
         return;
 
     win.exec();
 }
 
 }
 }