moriyoshi Mon Mar 31 15:25:57 2003 EDT
Modified files:
/phpdoc/en/reference/imap/functions imap-utf7-decode.xml
imap-utf7-encode.xml
imap-utf8.xml
Log:
Fixed bug #21601
Index: phpdoc/en/reference/imap/functions/imap-utf7-decode.xml
diff -u phpdoc/en/reference/imap/functions/imap-utf7-decode.xml:1.2
phpdoc/en/reference/imap/functions/imap-utf7-decode.xml:1.3
--- phpdoc/en/reference/imap/functions/imap-utf7-decode.xml:1.2 Wed Apr 17 02:39:23
2002
+++ phpdoc/en/reference/imap/functions/imap-utf7-decode.xml Mon Mar 31 15:25:57
2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/imap.xml, last change in rev 1.16 -->
<refentry id="function.imap-utf7-decode">
<refnamediv>
@@ -15,14 +15,18 @@
<methodparam><type>string</type><parameter>text</parameter></methodparam>
</methodsynopsis>
<para>
- Decodes modified UTF-7 <parameter>text</parameter> into 8bit data.
+ Decodes modified UTF-7 <parameter>text</parameter> into ISO-8859-1 string.
</para>
<para>
- Returns the decoded 8bit data, or &false; if the input string was
- not valid modified UTF-7. This function is needed to decode
- mailbox names that contain international characters outside of
- the printable ASCII range. The modified UTF-7 encoding is defined
- in <ulink url="&url.rfc;rfc2060.html">RFC 2060</ulink>, section
+ Returns a string that is encoded in ISO-8859-1 and consists of the same
+ sequence of characters in <parameter>text</parameter>, or &false;
+ if <parameter>text</parameter> contains invalid modified UTF-7 sequence
+ or <parameter>text</parameter> contains a character that is not part of
+ ISO-8859-1 character set.
+ This function is needed to decode mailbox names that contain certain
+ characters which are not in range of printable ASCII characters.
+ The modified UTF-7 encoding is defined in
+ <ulink url="&url.rfc;rfc2060.html">RFC 2060</ulink>, section
5.1.3 (original UTF-7 was defned in <ulink
url="&url.rfc;rfc1642.html">RFC1642</ulink>).
</para>
Index: phpdoc/en/reference/imap/functions/imap-utf7-encode.xml
diff -u phpdoc/en/reference/imap/functions/imap-utf7-encode.xml:1.2
phpdoc/en/reference/imap/functions/imap-utf7-encode.xml:1.3
--- phpdoc/en/reference/imap/functions/imap-utf7-encode.xml:1.2 Wed Apr 17 02:39:23
2002
+++ phpdoc/en/reference/imap/functions/imap-utf7-encode.xml Mon Mar 31 15:25:57
2003
@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/imap.xml, last change in rev 1.9 -->
<refentry id="function.imap-utf7-encode">
<refnamediv>
<refname>imap_utf7_encode</refname>
<refpurpose>
- Converts 8bit data to modified UTF-7 text.
+ Converts ISO-8859-1 string to modified UTF-7 text.
</refpurpose>
</refnamediv>
<refsect1>
@@ -15,10 +15,11 @@
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
- Converts 8bit <parameter>data</parameter> to modified UTF-7
- text. This is needed to encode mailbox names that contain
- international characters outside of the printable ASCII
- range. The modified UTF-7 encoding is defined in <ulink
+ Converts <parameter>data</parameter> to modified UTF-7
+ text. This is needed to encode mailbox names that contain certain
+ characters which are not in range of printable ASCII characters.
+ Note that <parameter>data</parameter> is expected to be
+ encoded in ISO-8859-1. The modified UTF-7 encoding is defined in <ulink
url="&url.rfc;rfc2060.html">RFC 2060</ulink>, section 5.1.3
(original UTF-7 was defned in <ulink
url="&url.rfc;rfc1642.html">RFC1642</ulink>).
Index: phpdoc/en/reference/imap/functions/imap-utf8.xml
diff -u phpdoc/en/reference/imap/functions/imap-utf8.xml:1.2
phpdoc/en/reference/imap/functions/imap-utf8.xml:1.3
--- phpdoc/en/reference/imap/functions/imap-utf8.xml:1.2 Wed Apr 17 02:39:23
2002
+++ phpdoc/en/reference/imap/functions/imap-utf8.xml Mon Mar 31 15:25:57 2003
@@ -1,23 +1,26 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/imap.xml, last change in rev 1.7 -->
<refentry id="function.imap-utf8">
<refnamediv>
<refname>imap_utf8</refname>
<refpurpose>
- Converts text to UTF8
+ Converts MIME-encoded text to UTF-8
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>imap_utf8</methodname>
- <methodparam><type>string</type><parameter>text</parameter></methodparam>
+ <methodparam>
+ <type>string</type><parameter>mime_encoded_text</parameter>
+ </methodparam>
</methodsynopsis>
<para>
- Converts the given <parameter>text</parameter> to
- UTF8 (as defined in
- <ulink url="&url.rfc;rfc2044.html">RFC2044</ulink>).
+ Converts the given <parameter>mime_encoded_text</parameter> to
+ UTF-8. MIME encoding method and the UTF-8 specification are described in
+ <ulink url="&url.rfc;rfc2047.html">RFC2047</ulink> and
+ <ulink url="&url.rfc;rfc2044.html">RFC2044</ulink> respectively.
</para>
</refsect1>
</refentry>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
