[interchange] Document UserDB encryption method parameters in source code comments.

[Dan Browning]

commit 1c11564db79eda0150909316881fa6b32bd3cb90
Author: Daniel Browning <db at kavod.com>
Date:   Fri Apr 1 19:39:34 2011 -0700

    Document UserDB encryption method parameters in source code comments.

 lib/Vend/UserDB.pm |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
---
diff --git a/lib/Vend/UserDB.pm b/lib/Vend/UserDB.pm
index f74af93..a17b461 100644
--- a/lib/Vend/UserDB.pm
+++ b/lib/Vend/UserDB.pm
@@ -46,6 +46,11 @@ if ($@) {
     ::logGlobal("SHA1 passwords disabled: $@");
 }
 
+# The object encryption methods take three arguments: object, password, and
+# mystery meat. If called in the context of new_account(), the mystery meat
+# is the salt (which is not always used). If called in the context of
+# login(), then the mystery meat is the entire password field from the
+# database (with salt, if applicable).
 my %enc_subs = (
     default => sub {
         my $obj = shift;