diff options
author | Piers Lauder <piers@cs.su.oz.au> | 2004-05-20 12:12:58 (GMT) |
---|---|---|
committer | Piers Lauder <piers@cs.su.oz.au> | 2004-05-20 12:12:58 (GMT) |
commit | 8bc81fc5c76d99c179fc6d0073fc3cfe034c1af2 (patch) | |
tree | 0a948671a8bf928ed189bc33f6aae6d50a2e75d5 /Doc | |
parent | c1e32b651896e24877e0e601fd7eb6215dbb916d (diff) | |
download | cpython-8bc81fc5c76d99c179fc6d0073fc3cfe034c1af2.zip cpython-8bc81fc5c76d99c179fc6d0073fc3cfe034c1af2.tar.gz cpython-8bc81fc5c76d99c179fc6d0073fc3cfe034c1af2.tar.bz2 |
Added description for authenticate and namespace
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/lib/libimaplib.tex | 27 |
1 files changed, 23 insertions, 4 deletions
diff --git a/Doc/lib/libimaplib.tex b/Doc/lib/libimaplib.tex index 2ebd0c1..67da9ae 100644 --- a/Doc/lib/libimaplib.tex +++ b/Doc/lib/libimaplib.tex @@ -138,12 +138,26 @@ An \class{IMAP4} instance has the following methods: \begin{methoddesc}{append}{mailbox, flags, date_time, message} - Append message to named mailbox. + Append \var{message} to named mailbox. \end{methoddesc} -\begin{methoddesc}{authenticate}{func} - Authenticate command --- requires response processing. This is - currently unimplemented, and raises an exception. +\begin{methoddesc}{authenticate}{mechanism, authobject} + Authenticate command --- requires response processing. + + \var{mechanism} specifies which authentication mechanism is to + be used - it should appear in the instance variable \code{capabilities} in the + form \code{AUTH=mechanism}. + + \var{authobject} must be a callable object: + +\begin{verbatim} +data = authobject(response) +\end{verbatim} + + It will be called to process server continuation responses. + It should return \code{data} that will be encoded and sent to server. + It should return \code{None} if the client abort response \samp{*} should + be sent instead. \end{methoddesc} \begin{methoddesc}{check}{} @@ -228,6 +242,11 @@ An \class{IMAP4} instance has the following methods: Returned data are tuples of message part envelope and data. \end{methoddesc} +\begin{methoddesc}{namespace}{} + Returns IMAP namespaces as defined in RFC2342. +\versionadded{2.3} +\end{methoddesc} + \begin{methoddesc}{noop}{} Send \samp{NOOP} to server. \end{methoddesc} |