diff --git a/offlineimap.conf b/offlineimap.conf
index 07f9901..b8f2469 100644
--- a/offlineimap.conf
+++ b/offlineimap.conf
@@ -941,16 +941,17 @@ remoteuser = username
 # folders, UNLESS the second values are filtered out by folderfilter below.
 # Failure to follow this rule will result in undefined behavior.
 #
-# See the user documentation for details and use cases. They are also online at:
-# http://docs.offlineimap.org/en/latest/nametrans.html
+# If you enable nametrans, you will likely need to set the reversed nametrans on
+# the other side. See the user documentation for details and use cases. They
+# are also online at: http://offlineimap.org/doc/nametrans.html
 #
 # This example below will remove "INBOX." from the leading edge of folders
 # (great for Courier IMAP users).
 #
 #nametrans = lambda foldername: re.sub('^INBOX\.', '', foldername)
 #
-# Using Courier remotely and want to duplicate its mailbox naming
-# locally?  Try this:
+# Using Courier remotely and want to duplicate its mailbox naming locally?  Try
+# this:
 #
 #nametrans = lambda foldername: re.sub('^INBOX\.*', '.', foldername)