diff --git a/functions/mbstring.xml b/functions/mbstring.xml
index 32207cba42..a631b0d083 100644
--- a/functions/mbstring.xml
+++ b/functions/mbstring.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.17 $ -->
+<!-- $Revision: 1.18 $ -->
  <reference id="ref.mbstring">
   <title>Multi-Byte String Functions</title> 
   <titleabbrev>
@@ -1929,7 +1929,7 @@ $convmap = array (
     <para>
      <parameter>to</parameter> is mail addresses send to. Multiple
      recipients can be specified by putting a comma between each
-     address in to.
+     address in to. This parameter is not automatically encoded.
     </para>
     <para>
      <parameter>subject</parameter> is subject of mail.
@@ -1941,7 +1941,7 @@ $convmap = array (
      <parameter>additional_headers</parameter> is inserted at
      the end of the header. This is typically used to add extra
      headers.  Multiple extra headers are separated with a
-     newline(\n).
+     newline ("\n").
     </para>
     <para>
      <parameter>additional_parameter</parameter> is a MTA command line
@@ -1949,12 +1949,12 @@ $convmap = array (
      header when using sendmail.
     </para>
     <para>
-     It returns &true; for success, otherwise it
-     returns &false;.
+     &return.success;
     </para>
     <para>
-     See also: <function>mb_language</function>,
-     <function>mail</function>.
+     See also <function>mail</function>,
+     <function>mb_encode_mimeheader</function>, and
+     <function>mb_language</function>.
     </para>
    </refsect1>
   </refentry>