Doc update from Piers Lauder see changes for imaplib.py version 2.16.
diff --git a/Doc/lib/libimaplib.tex b/Doc/lib/libimaplib.tex
index c275a6e..d20a53e 100644
--- a/Doc/lib/libimaplib.tex
+++ b/Doc/lib/libimaplib.tex
@@ -41,6 +41,12 @@
exception.
\end{excdesc}
+\begin{excdesc}{IMAP4.readonly}
+This exception is raised when a writeable mailbox has its status changed by the server. This is a
+sub-class of \exception{IMAP4.error}. Some other client now has write permission,
+and the mailbox will need to be re-opened to re-obtain write permission.
+\end{excdesc}
+
The following utility functions are defined:
\begin{funcdesc}{Internaldate2tuple}{datestr}
@@ -84,6 +90,13 @@
All IMAP4rev1 commands are represented by methods of the same name,
either upper-case or lower-case.
+All arguments to commands are converted to strings, except for
+AUTHENTICATE, and the last argument to APPEND which is passed as
+an IMAP4 literal. If necessary (the string contains
+IMAP4 protocol-sensitive characters and isn't enclosed with either parentheses or
+double quotes) each string is quoted. However, the \var{password}
+argument to the LOGIN command is always quoted.
+
Each command returns a tuple: \code{(\var{type}, [\var{data},
...])} where \var{type} is usually \code{'OK'} or \code{'NO'},
and \var{data} is either the text from the command response, or
@@ -144,6 +157,7 @@
\begin{methoddesc}{login}{user, password}
Identify the client using a plaintext password.
+ The \var{password} will be quoted.
\end{methoddesc}
\begin{methoddesc}{logout}{}
@@ -157,6 +171,20 @@
Returned data are tuples of message part envelope and data.
\end{methoddesc}
+\begin{methoddesc}{noop}{}
+ Send NOOP to server.
+\end{methoddesc}
+
+\begin{methoddesc}{open}{host, port}
+ Opens socket to \var{port} at \var{host}.
+ You may override this method.
+\end{methoddesc}
+
+\begin{methoddesc}{partial}{message_num, message_part, start, length}
+ Fetch truncated part of a message.
+ Returned data is a tuple of message part envelope and data.
+\end{methoddesc}
+
\begin{methoddesc}{recent}{}
Prompt server for an update. Returned data is \code{None} if no new
messages, else value of \samp{RECENT} response.
@@ -183,6 +211,10 @@
to the mailbox are not allowed.
\end{methoddesc}
+\begin{methoddesc}{socket}{}
+ Returns socket instance used to connect to server.
+\end{methoddesc}
+
\begin{methoddesc}{status}{mailbox, names}
Request named status conditions for \var{mailbox}.
\end{methoddesc}