derick Sun Jul 20 04:02:20 2003 EDT
Modified files:
/phpdoc/en/reference/mail/functions ezmlm-hash.xml mail.xml
Log:
- Reverting Greek in the English tree
Index: phpdoc/en/reference/mail/functions/ezmlm-hash.xml
diff -u phpdoc/en/reference/mail/functions/ezmlm-hash.xml:1.10
phpdoc/en/reference/mail/functions/ezmlm-hash.xml:1.11
--- phpdoc/en/reference/mail/functions/ezmlm-hash.xml:1.10 Sat Jul 19 20:09:10
2003
+++ phpdoc/en/reference/mail/functions/ezmlm-hash.xml Sun Jul 20 04:02:20 2003
@@ -1,25 +1,24 @@
-<?xml version="1.0" encoding="iso-8859-7"?>
-<!-- $Revision: 1.10 $ -->
-<!-- En-Revision: 1.9 Maintainer: legionnaire Status: ready -->
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.11 $ -->
<!-- splitted from ./en/functions/mail.xml, last change in rev 1.6 -->
<refentry id="function.ezmlm-hash">
<refnamediv>
<refname>ezmlm_hash</refname>
- <refpurpose>���������� ��� ���� hash ��� ���������� ��� �� EZMLM</refpurpose>
+ <refpurpose>Calculate the hash value needed by EZMLM</refpurpose>
</refnamediv>
<refsect1>
- <title>���������</title>
+ <title>Description</title>
<methodsynopsis>
<type>int</type><methodname>ezmlm_hash</methodname>
<methodparam><type>string</type><parameter>addr</parameter></methodparam>
</methodsynopsis>
<simpara>
- � <function>ezmlm_hash</function> ���������� ��� ���� hash ��� ����������
- ���� ��� ��������� EZMLM mailing lists �� ��� MySQL database.
+ <function>ezmlm_hash</function> calculates the hash value needed
+ when keeping EZMLM mailing lists in a MySQL database.
</simpara>
<para>
<example>
- <title>������������� �� hash ��� ����������� ��� ������</title>
+ <title>Calculating the hash and subscribing a user</title>
<programlisting>
<![CDATA[
$user = "[EMAIL PROTECTED]";
Index: phpdoc/en/reference/mail/functions/mail.xml
diff -u phpdoc/en/reference/mail/functions/mail.xml:1.18
phpdoc/en/reference/mail/functions/mail.xml:1.19
--- phpdoc/en/reference/mail/functions/mail.xml:1.18 Sat Jul 19 20:09:10 2003
+++ phpdoc/en/reference/mail/functions/mail.xml Sun Jul 20 04:02:20 2003
@@ -1,14 +1,13 @@
-<?xml version="1.0" encoding="iso-8859-7"?>
-<!-- $Revision: 1.18 $ -->
-<!-- En-Revision: 1.17 Maintainer: legionnaire Status: ready -->
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.19 $ -->
<!-- splitted from ./en/functions/mail.xml, last change in rev 1.2 -->
<refentry id="function.mail">
<refnamediv>
<refname>mail</refname>
- <refpurpose>�������� mail</refpurpose>
+ <refpurpose>send mail</refpurpose>
</refnamediv>
<refsect1>
- <title>���������</title>
+ <title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>mail</methodname>
<methodparam><type>string</type><parameter>to</parameter></methodparam>
@@ -18,19 +17,19 @@
<methodparam
choice="opt"><type>string</type><parameter>additional_parameters</parameter></methodparam>
</methodsynopsis>
<simpara>
- � <function>mail</function> �������� ������� �� mail �� ������
- ���� �������� ��� <parameter>message</parameter> ���� ���������
- ���� �������� ��� <parameter>to</parameter>. ��������� ���������� �������
- �� �������� �� ��� �������� ���� �������� ������� �� ���� ��������� ���
- <parameter>to</parameter>. Email �� ��������� ������ ��� ��������
- ������ ������������ ������� �� ���������� �� ��� ����� ����� ��� ����������.
���� ����������������
- ���� MIME-������������� - ��� ������������ �����������, ����� ����:
+ <function>mail</function> automatically mails the message
+ specified in <parameter>message</parameter> to the receiver
+ specified in <parameter>to</parameter>. Multiple recipients can
+ be specified by putting a comma between each address in
+ <parameter>to</parameter>. Email with attachments and special
+ types of content can be sent using this function. This is
+ accomplished via MIME-encoding - for more information, see this
<ulink url="&url.email.mime.zend;">
- �� ����� Zend</ulink> � ���<ulink url="&url.email.mime.pear;">
+ Zend article</ulink> or the <ulink url="&url.email.mime.pear;">
PEAR Mime Classes</ulink>.
</simpara>
<simpara>
- �� �������� RFC's ������� ������ �� ���������:
+ The following RFC's may also be useful:
<ulink url="&url.rfc;1896">RFC 1896</ulink>,
<ulink url="&url.rfc;2045">RFC 2045</ulink>,
<ulink url="&url.rfc;2046">RFC 2046</ulink>,
@@ -39,29 +38,29 @@
<ulink url="&url.rfc;2049">RFC 2049</ulink>.
</simpara>
<para>
- � <function>mail</function> ���������� &true; ��� �� mail ����������
- ��������, &false; �� �������� ���������.
+ <function>mail</function> returns &true; if the mail was successfully
+ accepted for delivery, &false; otherwise.
</para>
<warning>
<para>
- � ����������� ��� Windows ��� <function>mail</function> �������� �������������
- ��� ��� ���������� ��� UNIX. ��������, ��� ������������ ��� ������ binary ������
- ��� �� �������� �������� ���� ���� ������� �� direct sockets ��� �������� ���
���
- <literal>MTA</literal> ���������� ��� �� "������" �� ��� network socket (��
�����
- ������ �� ����� ���� ��� localhost -������- ���� ��� ������������� ��������).
������, �� custom
- headers ���� <literal>From:</literal>, <literal>Cc:</literal>,
- <literal>Bcc:</literal> ��� <literal>Date:</literal> <emphasis
- role="strong">���</emphasis> ������������ ��� �� <literal>MTA</literal>
- ���� ����, ���� ���������� ��� ��� <literal>PHP</literal>.
- � <literal>PHP</literal> < 4.3 ���������� ���� �� �������� header
<literal>Cc:</literal>
- (��� ���� case-sensitive). � <literal>PHP</literal> >= 4.3
- ����������� ��� �� �������������� �������� header ��� ��� ����� �����
+ 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 elements and is no longer
case-sensitive.
</para>
</warning>
<para>
<example>
- <title>���������� mail.</title>
+ <title>Sending mail.</title>
<programlisting>
<![CDATA[
<?php
@@ -72,21 +71,21 @@
</example>
</para>
<simpara>
- ��� �������� ��� fourth string argument, ���� �� string ��������� ���
- ����� ��� header. ���� ��������������� ������ ��� �� ���������� ��������
- headers. ��������� �������� headers ���������� �� ��� return (enter)
- ��� ��� ��� ������.
+ If a fourth string argument is passed, this string is inserted at
+ the end of the header. This is typically used to add extra
+ headers. Multiple extra headers are separated with a carriage return
+ and newline.
</simpara>
<note>
<para>
- ������ �� �������������� �� <literal>\r\n</literal> ��� �� �������� �� headers,
�� ���
- ������� Unix mail transfer agents ��������� �� ��������� ���� �� ��� ��� ������
+ You must use <literal>\r\n</literal> to separate headers, although
+ some Unix mail transfer agents may work with just a single newline
(<literal>\n</literal>).
</para>
</note>
<para>
<example>
- <title>���������� mail �� �������� headers.</title>
+ <title>Sending mail with extra headers.</title>
<programlisting>
<![CDATA[
<?php
@@ -100,17 +99,17 @@
</example>
</para>
<para>
- � ���������� <parameter>additional_parameters</parameter>
- ������ �� �������������� ��� �� �������� ��� ����������� ���������� ���
���������, �� ����� ���� ���������
- �� ������������ ���� ��������� mail �� ����� ��� <literal>sendmail_path</literal>
- ��������. ��� ����������, ���� ������ �� �������������� ��� �� ������
- ��� ��������� ��� ��������� ���� ������� ����� ��� sendmail �� ��� �������
- <literal>-f</literal>. ���� ��������� �� ����������
- ��� ������, ��� � web server ��� ������������ ������� �� ��� ��������� ���
sendmail,
- ��� �� ���������� �� ��������� ��� ������ ��� 'X-Warning' header ����
- ������� ��� ��������� �� ���� �� ������.
+ The <parameter>additional_parameters</parameter> parameter
+ can be used to pass an additional parameter to the program configured
+ to use when sending mail using the <literal>sendmail_path</literal>
+ configuration setting. For example, this can be used to set the
+ envelope sender address when using sendmail with the
+ <literal>-f</literal> sendmail option. You may need to add
+ the user that your web server runs as to your sendmail configuration
+ to prevent a 'X-Warning' header from being added to the message when
+ you set the envelope sender using this method.
<example>
- <title>���������� mail �� �������� headers ��� ��������� ��� �����������
command line ���������.</title>
+ <title>Sending mail with extra headers and setting an additional command line
parameter.</title>
<programlisting>
<![CDATA[
<?php
@@ -123,17 +122,17 @@
</para>
<note>
<para>
- ���� � ������ ���������� ���������� ���� PHP 4.0.5. ��� ��� PHP 4.2.3 ����
- � ���������� ����� ���������������� ��� <link
linkend="ini.safe-mode">safe_mode</link>
- ��� � ��������� <function>mail</function> �� ��������� ��� ������ �������������
- ��� �� ���������� &false; ��� ����������� �� ��� ���������������.
+ This fifth parameter was added in PHP 4.0.5. Since PHP 4.2.3 this
+ parameter is disabled in <link linkend="ini.safe-mode">safe_mode</link>
+ and the <function>mail</function> function will expose a warning message
+ and return &false; if you're trying to use it.
</para>
</note>
<para>
- �������� ������ �� ��������������� ����� �������� string building ��� ��
������������� ���������
- �������� email.
+ You can also use simple string building techniques to build complex
+ email messages.
<example>
- <title>���������� ��������� email.</title>
+ <title>Sending complex email.</title>
<programlisting>
<![CDATA[
<?php
@@ -186,21 +185,21 @@
</para>
<note>
<para>
- ��������� �� ��� ����� ������ newline ���������� ���
- <parameter>to</parameter> � <parameter>subject</parameter>,
- ����������� �� mail ���� �� ��� ������ �����.
+ Make sure you do not have any newline characters in the
+ <parameter>to</parameter> or <parameter>subject</parameter>,
+ or the mail may not be sent properly.
</para>
</note>
<note>
<para>
- � <parameter>to</parameter> ���������� ��� ������ �� ����� ��� ���������
- ��� ������ "Something <[EMAIL PROTECTED]>". �
- ������ mail ��� �� �� �������� ����� ���� ��� ����������� �� ��
- MTA.
+ The <parameter>to</parameter> parameter cannot be an address
+ in the form of "Something <[EMAIL PROTECTED]>". The
+ mail command will not parse this properly while talking with
+ the MTA.
</para>
</note>
<para>
- ����� ������ <function>imap_mail</function>.
+ See also <function>imap_mail</function>.
</para>
</refsect1>
</refentry>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php