| -rw-r--r-- | libopie2/opiesecurity/multiauthpassword.cpp | 11 | ||||
| -rw-r--r-- | libopie2/opiesecurity/multiauthpassword.h | 4 |
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 @@ -45,62 +45,61 @@ #include <qpushbutton.h> #include <qlabel.h> #include <qdir.h> #include "multiauthpassword.h" namespace Opie { 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(); } } } 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 @@ -10,50 +10,50 @@ _;:, .> :=|. This library is free software; you can .> <`_, > . <= redistribute it and/or modify it under :`=1 )Y*s>-.-- : the terms of the GNU Library General Public .="- .-=="i, .._ License as published by the Free Software - . .-<_> .<> Foundation; either version 2 of the License, ._= =} : or (at your option) any later version. .%`+i> _;_. .i_,=:_. -<s. This library is distributed in the hope that + . -:. = it will be useful, but WITHOUT ANY WARRANTY; : .. .:, . . . without even the implied warranty of =_ + =;=|` MERCHANTABILITY or FITNESS FOR A _.=:. : :=>`: PARTICULAR PURPOSE. See the GNU ..}^=.= = ; Library General Public License for more ++= -. .` .: details. : = ...= . :.=- -. .:....=;==+<; You should have received a copy of the GNU -_. . . )=. = Library General Public License along with -- :-=` this library; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ #ifndef OPIE_SEC_MULTIAUTHPASSWORD_H #define OPIE_SEC_MULTIAUTHPASSWORD_H namespace Opie { 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 * and only return if the user is able to authenticate with any of the * configured Authentication Plugins. - * This uses the \sa Opie::Security::MultiauthMainWindow internally. + * It uses the Opie::Security::MultiauthMainWindow QDialog internally. * * @author Clement Séveillac, Holger Freyther */ class MultiauthPassword { public: static bool needToAuthenticate( bool atpoweron = false ); static void authenticate(bool atpoweron = false); }; } } #endif |