[PATCH] Adding an entry to offlineimap.conf that explain how to use python code to query for a password.

[Thomas Kahle]

Signed-off-by: Thomas Kahle <tomka at gentoo.org>
---
 offlineimap.conf |   11 ++++++++++-
 1 files changed, 10 insertions(+), 1 deletions(-)

diff --git a/offlineimap.conf b/offlineimap.conf
index 869ac96..7018090 100644
--- a/offlineimap.conf
+++ b/offlineimap.conf
@@ -293,7 +293,7 @@ ssl = yes
 # Specify the remote user name.
 remoteuser = username
 
-# There are five ways to specify the password for the IMAP server:
+# There are six ways to specify the password for the IMAP server:
 #
 # 1. No password at all specified in the config file.
 #    If a matching entry is found in ~/.netrc (see netrc (5) for
@@ -324,6 +324,15 @@ remoteuser = username
 #    installed, you should not specify a remotepass.  If the user has a
 #    valid Kerberos TGT, OfflineIMAP will figure out the rest all by
 #    itself, and fall back to password authentication if needed.
+#
+# 6. Using arbitrary python code.  With this method, you invoke a
+#    function from your pythonfile.  To use this method assign the name
+#    of the function to the variable 'remotepasseval'.  Example:
+#    remotepasseval = get_password("imap.example.net")
+#    You can also query for the username:
+#    remoteusereval = get_username("imap.example.net")
+#    This method can be used to design more elaborate setups, e.g. by
+#    querying the gnome-keyring via its python bindings.
 
 ########## Advanced settings
 
-- 
1.7.3.4