mfischer Sat May 18 07:04:04 2002 EDT
Modified files:
/phpdoc/en/reference/mail/functions mail.xml
Log:
- Document latest Win32 mail() changes.
Index: phpdoc/en/reference/mail/functions/mail.xml
diff -u phpdoc/en/reference/mail/functions/mail.xml:1.4
phpdoc/en/reference/mail/functions/mail.xml:1.5
--- phpdoc/en/reference/mail/functions/mail.xml:1.4 Wed May 15 14:11:21 2002
+++ phpdoc/en/reference/mail/functions/mail.xml Sat May 18 07:04:04 2002
@@ -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 @@
<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>
