[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-commits
Subject:    kdelibs/kwallet/client
From:       George Staikos <staikos () kde ! org>
Date:       2003-10-20 18:46:45
[Download RAW message or body]

CVS commit by staikos: 

docupdate


  M +12 -1     kwallet.h   1.28


--- kdelibs/kwallet/client/kwallet.h  #1.27:1.28
@@ -120,5 +120,6 @@ class Wallet : public QObject, public DC
                  *  Open the wallet @p name.  The user will be prompted to
                  *  allow your application to open the wallet, and may be
-                 *  prompted for a password.
+                 *  prompted for a password.  You are responsible for deleting
+                 *  this object when you are done with it.
                  *  @param name The name of the wallet to open.
                  *  @param ot    If Asynchronous, the call will return
@@ -154,4 +155,7 @@ class Wallet : public QObject, public DC
                 /**
                  *  The standardized name of the password folder.
+                 *  It is automatically created when a wallet is created, but
+                 *  the user may still delete it so you should check for its
+                 *  existence and recreate it if necessary and desired.
                  */
                 static const QString PasswordFolder();
@@ -159,4 +163,7 @@ class Wallet : public QObject, public DC
                 /**
                  *  The standardized name of the form data folder.
+                 *  It is automatically created when a wallet is created, but
+                 *  the user may still delete it so you should check for its
+                 *  existence and recreate it if necessary and desired.
                  */
                 static const QString FormDataFolder();
@@ -356,4 +363,6 @@ class Wallet : public QObject, public DC
                  *  Determine if a folder does not exist in a wallet.  This
                  *  does not require decryption of the wallet.
+                 *  This is a handy optimization to avoid prompting the user
+                 *  if your data is certainly not in the wallet.
                  *  @param wallet The wallet to look in.
                  *  @param folder The folder to look up.
@@ -366,4 +375,6 @@ class Wallet : public QObject, public DC
                  *  Determine if an entry in a folder does not exist in a
                  *  wallet.  This does not require decryption of the wallet.
+                 *  This is a handy optimization to avoid prompting the user
+                 *  if your data is certainly not in the wallet.
                  *  @param wallet The wallet to look in.
                  *  @param folder The folder to look in.


[prev in list] [next in list] [prev in thread] [next in thread]