jimw Fri Dec 14 16:24:58 2001 EDT
Modified files:
/phpdoc/en/functions imap.xml
Log:
imap_delete: note that imap_expunge needs to be called during the same connection on
pop3 mailboxes
Index: phpdoc/en/functions/imap.xml
diff -u phpdoc/en/functions/imap.xml:1.56 phpdoc/en/functions/imap.xml:1.57
--- phpdoc/en/functions/imap.xml:1.56 Wed Dec 12 15:46:57 2001
+++ phpdoc/en/functions/imap.xml Fri Dec 14 16:24:58 2001
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.56 $ -->
+<!-- $Revision: 1.57 $ -->
<reference id='ref.imap'>
<title>IMAP, POP3 and NNTP functions</title>
<titleabbrev>IMAP</titleabbrev>
@@ -530,8 +530,8 @@
Returns &true;.
</para>
<para>
- <function>imap_delete</function> function marks message pointed
- by <parameter>msg_number</parameter> for deletion. The optional
+ <function>imap_delete</function> marks messages listed
+ in <parameter>msg_number</parameter> for deletion. The optional
<parameter>flags</parameter> parameter only has a single option,
<parameter>FT_UID</parameter>, which tells the function to treat
the <parameter>msg_number</parameter> argument as a
@@ -541,6 +541,14 @@
<function>imap_close</function> is called with the optional
parameter CL_EXPUNGE.
</para>
+ <note>
+ <para>
+ POP3 mailboxes do not have their message flags saved between
+ connections, so <function>imap_expunge</function> must be called during
+ the same connection in order for messages marked for deletion to
+ actually be purged.
+ </para>
+ </note>
<para>
<example>
<title><function>imap_delete</function> Beispiel</title>
