diff --git a/functions/mail.xml b/functions/mail.xml
index f3d34b94c5..4266f22c48 100644
--- a/functions/mail.xml
+++ b/functions/mail.xml
@@ -7,7 +7,6 @@
    </simpara>
   </partintro>
 
-
   <refentry id="function.mail">
    <refnamediv>
     <refname>mail</refname>
@@ -36,6 +35,10 @@
       <parameter>to</parameter>. Multiple recipients can be specified by
       putting a comma between each address in <parameter>to</parameter>.
     </simpara>
+    <para>
+     <function>mail</function> returns <literal>TRUE</literal> if the mail
+     is sucessfully sent, <literal>FALSE</literal> otherwise.
+    </para>
     <para>
      <example>
       <title>Sending mail.</title>