diff --git a/reference/mail/functions/mail.xml b/reference/mail/functions/mail.xml
index 852a5c38d4..5bcae3511c 100644
--- a/reference/mail/functions/mail.xml
+++ b/reference/mail/functions/mail.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <!-- splitted from ./en/functions/mail.xml, last change in rev 1.2 -->
   <refentry id="function.mail">
    <refnamediv>
@@ -178,6 +178,17 @@ mail($to, $subject, $message, $headers);
        or the mail may not be sent properly.
      </para>
     </note>
+    <note>
+     <para>
+      The <parameter>to</parameter> parameter cannot be an address
+      in the form of &quot;Something &lt;someone@somewhere.com&gt&quot;.  The
+      mail command will not parse this properly while talking with 
+      the MTA.
+     </para>
+    </note>
+    <para>
+     See also <function>imap_mail</function>.
+    </para>
    </refsect1>
   </refentry>