--- a/doc/dovecot-ldap.conf	Tue Jul 12 19:09:25 2005 +0300
+++ b/doc/dovecot-ldap.conf	Tue Jul 12 21:14:44 2005 +0300
@@ -40,7 +40,8 @@
 #  System GID
 #user_attrs = uid,homeDirectory,,,uidNumber,gidNumber
 
-# Filter for user lookup. Some variables can be used:
+# Filter for user lookup. Some variables can be used (see
+# http://wiki.dovecot.org/Variables for full list):
 #   %u - username
 #   %n - user part in user@domain, same as %u if there's no domain
 #   %d - domain part in user@domain, empty if user there's no domain

--- a/doc/dovecot-sql.conf	Tue Jul 12 19:09:25 2005 +0300
+++ b/doc/dovecot-sql.conf	Tue Jul 12 21:14:44 2005 +0300
@@ -61,10 +61,15 @@
 # same casing as it's in database. The query can also return other fields
 # which have a special meaning, see http://wiki.dovecot.org/AuthSpecials
 #
-# Available substitutions:
+# Commonly used available substitutions (see
+# http://wiki.dovecot.org/Variables for full list):
 #   %u = entire userid
 #   %n = user part of user@domain
 #   %d = domain part of user@domain
+# 
+# Note that these can be used only as input to SQL query. If the query outputs
+# any of these substitutions, they're not touched. Otherwise it would be
+# difficult to have eg. usernames containing '%' characters.
 #
 # Example:
 #   password_query = SELECT password FROM users WHERE userid = '%n' AND domain = '%d'