[Python-checkins] python/dist/src/Doc/lib libimaplib.tex,1.31,1.32
fdrake at users.sourceforge.net
fdrake at users.sourceforge.net
Wed Jan 19 05:44:26 CET 2005
Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv6018/Doc/lib
Modified Files:
libimaplib.tex
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.31
retrieving revision 1.32
diff -u -d -r1.31 -r1.32
--- libimaplib.tex 1 Jan 2005 00:28:37 -0000 1.31
+++ libimaplib.tex 19 Jan 2005 04:44:07 -0000 1.32
@@ -143,6 +143,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
+(\code{'3:*'}).
+
An \class{IMAP4} instance has the following methods:
@@ -389,7 +396,18 @@
\end{methoddesc}
\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:
+
+\begin{verbatim}
+typ, data = M.search(None, 'ALL')
+for num in data[0].split():
+ M.store(num, '+FLAGS', '\\Deleted')
+M.expunge()
+\end{verbatim}
\end{methoddesc}
\begin{methoddesc}{subscribe}{mailbox}
@@ -473,5 +491,6 @@
for num in data[0].split():
typ, data = M.fetch(num, '(RFC822)')
print 'Message %s\n%s\n' % (num, data[0][1])
+M.close()
M.logout()
\end{verbatim}
More information about the Python-checkins
mailing list