diff --git a/src/docbkx/mail.xml b/src/docbkx/mail.xml
index 030719aba0..ba042533ce 100644
--- a/src/docbkx/mail.xml
+++ b/src/docbkx/mail.xml
@@ -113,7 +113,17 @@
should-delete-messages="false"
should-mark-messages-as-read="true"
java-mail-properties="javaMailProperties"/>]]>
+ ... where javaMailProperties could be provided by creating and populating
+ a regular java.utils.Properties object. For example via util namespace
+ provided by Spring.
+
+ javax.net.ssl.SSLSocketFactory
+ false
+ imaps
+false]]>
+
+
When using should-mark-messages-as-read be aware of the protocol you are using ti retrieve messages. For example POP3 does not support this flag
which means setting it to 'true' will have no effect.