[Python-checkins] CVS: python/dist/src/Doc/lib libimaplib.tex,1.17,1.18

[Piers Lauder]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv7206/dist/src/Doc/lib

Modified Files:
	libimaplib.tex 
Log Message:
apply patch item #416254

Index: libimaplib.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libimaplib.tex,v
retrieving revision 1.17
retrieving revision 1.18
diff -C2 -r1.17 -r1.18
*** libimaplib.tex	2001/01/11 04:19:52	1.17
--- libimaplib.tex	2001/07/20 11:04:19	1.18
***************
*** 157,160 ****
--- 157,165 ----
  \end{methoddesc}
  
+ \begin{methoddesc}{getacl}{mailbox}
+   Get the \samp{ACL}s for \var{mailbox}.
+   The method is non-standard, but is supported by the \samp{Cyrus} server.
+ \end{methoddesc}
+ 
  \begin{methoddesc}{list}{\optional{directory\optional{, pattern}}}
    List mailbox names in \var{directory} matching
***************
*** 186,189 ****
--- 191,196 ----
  \begin{methoddesc}{open}{host, port}
    Opens socket to \var{port} at \var{host}.
+   The connection objects established by this method
+   will be used in the \code{read}, \code{readline}, and \code{shutdown} methods.
    You may override this method.
  \end{methoddesc}
***************
*** 194,197 ****
--- 201,214 ----
  \end{methoddesc}
  
+ \begin{methoddesc}{read}{size}
+   Reads \var{size} bytes from the remote server.
+   You may override this method.
+ \end{methoddesc}
+ 
+ \begin{methoddesc}{readline}{}
+   Reads one line from the remote server.
+   You may override this method.
+ \end{methoddesc}
+ 
  \begin{methoddesc}{recent}{}
    Prompt server for an update. Returned data is \code{None} if no new
***************
*** 234,239 ****
  \end{methoddesc}
  
  \begin{methoddesc}{socket}{}
!   Returns socket instance used to connect to server. 
  \end{methoddesc}
  
--- 251,284 ----
  \end{methoddesc}
  
+ \begin{methoddesc}{setacl}{mailbox, who, what}
+   Set an \samp{ACL} for \var{mailbox}.
+   The method is non-standard, but is supported by the \samp{Cyrus} server.
+ \end{methoddesc}
+ 
+ \begin{methoddesc}{shutdown}{}
+   Close connection established in \code{open}.
+   You may override this method.
+ \end{methoddesc}
+ 
  \begin{methoddesc}{socket}{}
!   Returns socket instance used to connect to server.
! \end{methoddesc}
! 
! \begin{methoddesc}{sort}{sort_criteria, charset, search_criterium\optional{, ...}}
!   The \code{sort} command is a variant of \code{search} with sorting semantics for
!   the results.  Returned data contains a space
!   separated list of matching message numbers.
! 
!   Sort has two arguments before the \var{search_criterium}
!   argument(s); a parenthesized list of \var{sort_criteria}, and the searching \var{charset}.
!   Note that unlike \code{search}, the searching \var{charset} argument is mandatory.
!   There is also a \code{uid sort} command which corresponds to \code{sort} the way
!   that \code{uid search} corresponds to \code{search}.
!   The \code{sort} command first searches the mailbox for messages that
!   match the given searching criteria using the charset argument for
!   the interpretation of strings in the searching criteria.  It then
!   returns the numbers of matching messages.
! 
!   This is an \samp{IMAP4rev1} extension command.
  \end{methoddesc}
  
***************
*** 288,292 ****
  
  \begin{verbatim}
! import getpass, imaplib, string
  
  M = imaplib.IMAP4()
--- 333,337 ----
  
  \begin{verbatim}
! import getpass, imaplib
  
  M = imaplib.IMAP4()
***************
*** 294,298 ****
  M.select()
  typ, data = M.search(None, 'ALL')
! for num in string.split(data[0]):
      typ, data = M.fetch(num, '(RFC822)')
      print 'Message %s\n%s\n' % (num, data[0][1])
--- 339,343 ----
  M.select()
  typ, data = M.search(None, 'ALL')
! for num in data[0].split():
      typ, data = M.fetch(num, '(RFC822)')
      print 'Message %s\n%s\n' % (num, data[0][1])