summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorPiers Lauder <piers@cs.su.oz.au>2004-05-20 12:12:58 (GMT)
committerPiers Lauder <piers@cs.su.oz.au>2004-05-20 12:12:58 (GMT)
commit8bc81fc5c76d99c179fc6d0073fc3cfe034c1af2 (patch)
tree0a948671a8bf928ed189bc33f6aae6d50a2e75d5 /Doc
parentc1e32b651896e24877e0e601fd7eb6215dbb916d (diff)
downloadcpython-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.tex27
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}