[Python-checkins] python/dist/src/Doc/lib libimaplib.tex, 1.24,

fdrake at users.sourceforge.net fdrake at users.sourceforge.net
Wed Jan 19 05:49:30 CET 2005

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv7199/Doc/lib

Modified Files:
      Tag: release23-maint
Log Message:
Description of args to IMAP4.store() in imaplib
(closes SF patch #1084092; modified per comments in SF)

Index: libimaplib.tex
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libimaplib.tex,v
retrieving revision 1.24
retrieving revision
diff -u -d -r1.24 -r1.24.12.1
--- libimaplib.tex	27 Mar 2003 16:59:38 -0000	1.24
+++ libimaplib.tex	19 Jan 2005 04:49:26 -0000
@@ -134,6 +134,13 @@
 is the header of the response, and the second part contains
 the data (ie: 'literal' value).
+The \var{message_set} options to commands below is a string specifying one
+or more messages to be acted upon.  It may be a simple message number
+(\code{'1'}), a range of message numbers (\code{'2:4'}), or a group of
+non-contiguous ranges separated by commas (\code{'1:3,6:9'}).  A range
+can contain an asterisk to indicate an infinite upper bound
 An \class{IMAP4} instance has the following methods:
@@ -348,7 +355,18 @@
 \begin{methoddesc}{store}{message_set, command, flag_list}
-  Alters flag dispositions for messages in mailbox.
+  Alters flag dispositions for messages in mailbox.  \var{command} is
+  specified by section 6.4.6 of \rfc{2060} as being one of "FLAGS", "+FLAGS",
+  or "-FLAGS", optionally with a suffix of ".SILENT".
+  For example, to set the delete flag on all messages:
+typ, data = M.search(None, 'ALL')
+for num in data[0].split():
+   M.store(num, '+FLAGS', '\\Deleted')
@@ -409,5 +427,6 @@
 for num in data[0].split():
     typ, data = M.fetch(num, '(RFC822)')
     print 'Message %s\n%s\n' % (num, data[0][1])

More information about the Python-checkins mailing list