- Document latest Win32 mail() changes.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@82632 c90b9560-bf6c-de11-be94-00142212c4b1

reference/mail/functions/mail.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/mail.xml, last change in rev 1.2 -->
   <refentry id="function.mail">
    <refnamediv>
@@ -41,6 +41,23 @@
      <function>mail</function> returns &true; if the mail was successfully
      accepted for delivery, &false; otherwise.
     </para>
+    <warning>
+     <para>
+      The Windows implementation of <function>mail</function> differs in many
+      ways from the Unix implementation. First, it doesn't use a local binary
+      for composing messages but only operates on direct sockets which means a
+      <literal>MTA</literal> is needed listening on a network socket (which
+      can either on the localhost or a remote machine). Second, the custom
+      headers like <literal>From:</literal>, <literal>Cc:</literal>,
+      <literal>Bcc:</literal> and <literal>Date:</literal> are <emphasis
+      role="strong">not</emphasis> interpreted by the <literal>MTA</literal>
+      in the first place, but are parsed by <literal>PHP</literal>.
+      <literal>PHP</literal> < 4.3 only supported the <literal>Cc:</literal>
+      header element (and was case-sensitive).  <literal>PHP</literal> >= 4.3
+      supports all the mentioned header element and is no longer
+      case-sensitive.
+     </para>
+    </warning>
     <para>
      <example>
       <title>Sending mail.</title>
@@ -61,9 +78,7 @@ mail("joecool@example.com", "My Subject", "Line 1\nLine 2\nLine 3");
      <para>
      You must use <literal>\r\n</literal> to seperate headers, although
      some Unix mail transfer agents may work with just a single newline
-     (<literal>\n</literal>). The Cc: header is case sensitive and must
-     be written as <literal>Cc:</literal> on Win32 systems. The Bcc:
-     header is also not supported on Win32 systems.
+     (<literal>\n</literal>).
      </para>
     </note>
     <para>