From 348d5459c2698afb475f0cce636fce3958483def Mon Sep 17 00:00:00 2001
From: jim winstead <jimw@php.net>
Date: Fri, 14 Dec 2001 21:24:58 +0000
Subject: [PATCH] imap_delete: note that imap_expunge needs to be called during
 the same connection on pop3 mailboxes

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@65071 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/imap.xml | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/functions/imap.xml b/functions/imap.xml
index 11570a6246..f71be1836b 100644
--- a/functions/imap.xml
+++ b/functions/imap.xml
@@ -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 @@ imap_close($mbox);
      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 @@ imap_close($mbox);
      <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>