--- a/doc/configuration.txt	Wed Oct 16 00:25:15 2002 +0300
+++ b/doc/configuration.txt	Wed Oct 16 00:35:14 2002 +0300
@@ -130,5 +130,5 @@
 set up special chroot environment).
 
 Anyway, doing it is easy. configure --prefix=$HOME, make install, change
-login_user and auth_user in dovecot.conf to your user id and use
-passwd-file authentication.
+login_user and auth_user in dovecot.conf to your user id, disable all
+chrooting and use passwd-file authentication.

--- a/dovecot-example.conf	Wed Oct 16 00:25:15 2002 +0300
+++ b/dovecot-example.conf	Wed Oct 16 00:35:14 2002 +0300
@@ -1,7 +1,9 @@
 ## Dovecot 1.0 configuration file
 
 # Default values are shown after each value, it's not required to uncomment
-# any of the lines.
+# any of the lines. Exception to this are paths, they're just examples
+# with real defaults being based on configure options. The paths listed here
+# are for configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var
 
 # Port to listen in for IMAP connections. This port is used for TLS
 # connections as well. Setting it to 0 disables it.
@@ -18,7 +20,8 @@
 # to imap_listen if not specified.
 #imaps_listen = 
 
-# SSL certificate/key, they're opened as root
+# SSL certificate/key, they're opened as root. Note that these default paths
+# are absolute, configure options don't affect them.
 #ssl_cert_file = /etc/ssl/certs/imapd.pem
 #ssl_key_file = /etc/ssl/private/imapd.pem
 
@@ -48,7 +51,7 @@
 # root, so you don't need to give imap-auth any access for it.
 #login_dir = /var/run/dovecot/login
 
-# chroot() imap-login process to the login_dir. Only reason not to do this
+# chroot imap-login process to the login_dir. Only reason not to do this
 # is if you wish to run the whole imapd without roots.
 #login_chroot = yes
 
@@ -147,13 +150,14 @@
 auth_userinfo = pam
 
 # Executable location
-#auth_executable = /var/lib/dovecot/imap-auth
+#auth_executable = /usr/lib/dovecot/imap-auth
 
 # User to use for the process. Only shadow and pam authentication requires
 # roots, so use something else if possible.
 auth_user = root
 
-# Directory where to chroot the process
+# Directory where to chroot the process. Most authentication backends don't
+# work if this is set, and there's no point chrooting if auth_user is root.
 #auth_chroot = 
 
 # Number of authentication processes to create