author | clem <clem> | 2004-10-07 00:12:55 (UTC) |
---|---|---|
committer | clem <clem> | 2004-10-07 00:12:55 (UTC) |
commit | 08bb0269afae5ad4a23fc5677cdda6554342da5c (patch) (side-by-side diff) | |
tree | 21ddd5f576967ef390c555f6fa26a78a28a6e6c3 /libopie2/opiesecurity | |
parent | d2256c288998704c0b43986865c884070b983d89 (diff) | |
download | opie-08bb0269afae5ad4a23fc5677cdda6554342da5c.zip opie-08bb0269afae5ad4a23fc5677cdda6554342da5c.tar.gz opie-08bb0269afae5ad4a23fc5677cdda6554342da5c.tar.bz2 |
improved class comment
-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 @@ -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(); } } } 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 @@ -18,42 +18,42 @@ + . -:. = 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 |