From 1f2f7dac04f520f97853503197491978cb702dce Mon Sep 17 00:00:00 2001
From: Oleg Zhurakousky <ozhurakousky@vmware.com>
Date: Mon, 7 Mar 2011 18:26:19 -0500
Subject: [PATCH] INT-1802 added docs for replacing '@' with '%40' in the
 userid when its specified as part of the url

---
 docs/src/reference/docbook/mail.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/src/reference/docbook/mail.xml b/docs/src/reference/docbook/mail.xml
index 7fd2f1cfc8..107f840009 100644
--- a/docs/src/reference/docbook/mail.xml
+++ b/docs/src/reference/docbook/mail.xml
@@ -114,6 +114,9 @@
     ... where <emphasis>javaMailProperties</emphasis> could be provided by creating and populating
      a regular <classname>java.utils.Properties</classname> object. For example via <emphasis>util</emphasis> namespace
      provided by Spring.
+     <important>
+     	If your userid contains '@' character use '%40' instead of '@' to avoid parsing errors from he underlying JavaMail API
+     </important>
      <programlisting language="xml"><![CDATA[<util:properties id="javaMailProperties">
   <prop key="mail.imap.socketFactory.class">javax.net.ssl.SSLSocketFactory</prop>
   <prop key="mail.imap.socketFactory.fallback">false</prop>