[PHP-DOC] cvs: phpdoc-it /reference/mail reference.xml /reference/mail/functions mail.xml

[Simone Cortesi]

cortesi         Tue Jun  4 07:55:17 2002 EDT

  Modified files:              
    /phpdoc-it/reference/mail   reference.xml 
    /phpdoc-it/reference/mail/functions mail.xml 
  Log:
  updating the chapter"
  
  
Index: phpdoc-it/reference/mail/reference.xml
diff -u phpdoc-it/reference/mail/reference.xml:1.4 
phpdoc-it/reference/mail/reference.xml:1.5
--- phpdoc-it/reference/mail/reference.xml:1.4  Tue Jun  4 07:16:09 2002
+++ phpdoc-it/reference/mail/reference.xml      Tue Jun  4 07:55:16 2002
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.2 Maintainer: cortesi  Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: cortesi  Status: ready -->
 <!-- CREDITS: fabio -->
 <reference id="ref.mail">
   <title>Funzioni di Mail</title>
@@ -58,7 +58,12 @@
        al wrapper che i rispettivi sistemi di posta offrono, se esistenti.
        Per esempio, gli utenti di <ulink url="&url.qmail;">Qmail</ulink>
        possono normalmente impostarla a
-       <filename>/var/qmail/bin/sendmail</filename>.
+       <filename>/var/qmail/bin/sendmail</filename> o <filename>
+       /var/qmail/bin/qmail-inject</filename>.
+      </para>
+      <para>
+       <command>qmail-inject</command> non richiede nessuna opzione particolare
+       per processare correttamente le mail.
       </para>
      </listitem>
     </varlistentry>
Index: phpdoc-it/reference/mail/functions/mail.xml
diff -u phpdoc-it/reference/mail/functions/mail.xml:1.2 
phpdoc-it/reference/mail/functions/mail.xml:1.3
--- phpdoc-it/reference/mail/functions/mail.xml:1.2     Wed Apr 17 03:07:13 2002
+++ phpdoc-it/reference/mail/functions/mail.xml Tue Jun  4 07:55:17 2002
@@ -1,8 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.8 Maintainer: cortesi Status: ready -->
 <!-- splitted from ./it/functions/mail.xml, last change in rev 1.3 -->
-<!-- last change to 'mail' in en/ tree in rev 1.2 -->
-<!-- EN-Revision: 1.2 Maintainer: cortesi Status: ready -->
-<!-- OLD-Revision: 1.38/EN.1.2 -->
   <refentry id="function.mail">
    <refnamediv>
     <refname>mail</refname>
@@ -22,7 +20,8 @@
      <function>mail</function> invia automaticamente il messaggio specificato
      in <parameter>messaggio</parameter> al destinatario specificato in
      <parameter>a</parameter>. Destinatari multipli possono essere specificati
-     mettendo una virgola tra ogni indirizzo in <parameter>a</parameter>. Email con 
allegati e tipi speciali di
+     mettendo una virgola tra ogni indirizzo in <parameter>a</parameter>. 
+     Email con allegati e tipi speciali di
      contenuto possono essere spedite usando questa funzione. Questo �
      possibile tramite la codifica MIME. Per maggiori informazioni, fare riferimento a
      <ulink url="&url.email.mime.zend;">
@@ -39,9 +38,26 @@
      <ulink url="&url.rfc2049;">RFC 2049</ulink>.
     </simpara>
     <para>
-     <function>mail</function> restituisce &true; se la mail � stata spedita con
-     successo, altrimenti restituisce &false;.
+     <function>mail</function> restituisce &true; se la mail � stata accettata per
+     la spedizione con successo, altrimenti restituisce &false;.
     </para>
+    <warning>
+     <para>
+      L'implementazione Windows della funzione <function>mail</function> differisce 
+sotto molti
+      aspetti dall'implementazione Unix. Primo, non usa una un programma in locale
+      per comporre i messaggi, ma opera soltanto direttamente sui socket, il che 
+significa che deve 
+      essere presente in ascolto un <literal>MTA</literal> su un socket di rete (che 
+pu�
+      essere su localhost o su una macchina remota). Secondo, gli header custom
+      quali <literal>From:</literal>, <literal>Cc:</literal>,
+      <literal>Bcc:</literal> e <literal>Date:</literal> <emphasis
+      role="strong">non</emphasis> vengono interpretati subito dal 
+      <literal>MTA</literal>, ma ne viene fatto prima il parsing da parte di 
+<literal>PHP</literal>.
+      <literal>PHP</literal> &lt; 4.3 supportava solo gli header 
+<literal>Cc:</literal>
+      (ed era case-sensitive). <literal>PHP</literal> &gt;= 4.3
+      supporta tutti gli header e non � pi�
+      case-sensitive.
+     </para>
+    </warning>
     <para>
      <example>
       <title>Inviare mail.</title>
@@ -50,7 +66,8 @@
 mail("[EMAIL PROTECTED]", "Oggetto", "Linea 1\nLinea 2\nLinea 3");
 ]]>
       </programlisting>
-     </example></para>
+     </example>
+    </para>
     <simpara>
      Se viene passata come parametro una quarta stringa, questa stringa viene inserita
      alla fine dell'intestazione (header).  Ci� viene tipicamente usato per 
aggiungere intestazioni
@@ -58,13 +75,11 @@
      di "a capo" (sia newline che carriage return).
     </simpara>
     <note>
-    <para>
+     <para>
      &Egrave; necessario usare <literal>\r\n</literal> per separare le intestazioni,
      alcuni mail transfer agent sotto Unix potrebbero funzionare anche solo con un 
singolo newline
-     (<literal>\n</literal>). L'intestazione Cc: � case sensitive e deve essere 
scritta
-     esattamente cos� <literal>Cc:</literal> sui sistemi Win32. L'intestazione Bcc:
-     non � supportata dai sistemi Win32.
-    </para>
+     (<literal>\n</literal>).
+     </para>
     </note>
     <para>
      <example>
@@ -131,6 +146,8 @@
  </tr>
  <tr>
   <td>Giovanni</td><td>3</td><td>Agosto</td><td>1970</td>
+ </tr>
+ <tr>
   <td>Sara</td><td>17</td><td>Agosto</td><td>1973</td>
  </tr>
 </table>