===================================================================
RCS file: /cvs/palm/Palm-Keyring/lib/Palm/Keyring.pm,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- palm/Palm-Keyring/lib/Palm/Keyring.pm	2007/02/22 04:11:35	1.35
+++ palm/Palm-Keyring/lib/Palm/Keyring.pm	2007/02/22 05:16:04	1.36
@@ -1,5 +1,5 @@
 package Palm::Keyring;
-# $RedRiver: Keyring.pm,v 1.34 2007/02/21 05:24:14 andrew Exp $
+# $RedRiver: Keyring.pm,v 1.35 2007/02/22 04:11:35 andrew Exp $
 ########################################################################
 # Keyring.pm *** Perl class for Keyring for Palm OS databases.
 #
@@ -1344,6 +1344,14 @@
 
 =back
 
+For v5 databases there are some additional appinfo fields set.
+
+	$pdb->{appinfo} = {
+		# normal appinfo stuff described in L<Palm::StdAppInfo>
+		cipher     => The index number of the cipher being used
+		iter       => Number of iterations for the cipher
+	};
+
 =head2 crypt
 
 Pass in the alias of the crypt to use, or the index.
@@ -1362,7 +1370,6 @@
         default_iter => <default iterations for the cipher>,
     };
 
-
 =head2 Encrypt
 
     $pdb->Encrypt($rec, $acct[, $password[, $ivec]]);
@@ -1457,6 +1464,28 @@
 the password. 
 
 If nothing is passed, it forgets the password that it was remembering.
+
+After a successful password verification the following fields are set
+
+For v4
+
+	$pdb->{digest}   = the calculated digest used from the key;
+	$pdb->{password} = the password that was passed in;
+
+For v5
+
+	$pdb->{appinfo} = {
+		# As described under new() with these additional fields
+		cipher     => The index number of the cipher being used
+		iter       => Number of iterations for the cipher
+		key        => The key that is calculated from the password 
+		              and salt and is used to decrypt the records.
+		masterhash => the hash of the key that is stored in the 
+		              database.  Either set when Loading the database
+					  or when setting a new password.
+		salt       => the salt that is either read out of the database 
+		              or calculated when setting a new password.
+	};
 
 =head1 DEPENDENCIES