summaryrefslogtreecommitdiff
path: root/Doc
diff options
context:
space:
mode:
authorDong-hee Na <donghee.na92@gmail.com>2020-04-27 23:52:55 +0900
committerGitHub <noreply@github.com>2020-04-27 23:52:55 +0900
commitc5c42815ecb560bbf34db99b0e15fe9b604be889 (patch)
tree819b18345d9d082af9ed6db4e51e9ab566a31538 /Doc
parent91a5ae18351027867e99c96db5ea235d9c42e47a (diff)
downloadcpython-git-c5c42815ecb560bbf34db99b0e15fe9b604be889.tar.gz
bpo-40375: Implement imaplib.IMAP4.unselect (GH-19712)
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/imaplib.rst9
-rw-r--r--Doc/whatsnew/3.9.rst7
2 files changed, 16 insertions, 0 deletions
diff --git a/Doc/library/imaplib.rst b/Doc/library/imaplib.rst
index 5b8ca7ce68..7c5b075016 100644
--- a/Doc/library/imaplib.rst
+++ b/Doc/library/imaplib.rst
@@ -582,6 +582,15 @@ An :class:`IMAP4` instance has the following methods:
Unsubscribe from old mailbox.
+.. method:: IMAP4.unselect()
+
+ :meth:`imaplib.IMAP4.unselect` frees server's resources associated with the
+ selected mailbox and returns the server to the authenticated
+ state. This command performs the same actions as :meth:`imaplib.IMAP4.close`, except
+ that no messages are permanently removed from the currently
+ selected mailbox.
+
+ .. versionadded:: 3.9
.. method:: IMAP4.xatom(name[, ...])
diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
index 728e6001da..0b15ec7364 100644
--- a/Doc/whatsnew/3.9.rst
+++ b/Doc/whatsnew/3.9.rst
@@ -320,6 +320,13 @@ with this change. The overridden methods of :class:`~imaplib.IMAP4_SSL` and
:class:`~imaplib.IMAP4_stream` were applied to this change.
(Contributed by Dong-hee Na in :issue:`38615`.)
+:meth:`imaplib.IMAP4.unselect` is added.
+:meth:`imaplib.IMAP4.unselect` frees server's resources associated with the
+selected mailbox and returns the server to the authenticated
+state. This command performs the same actions as :meth:`imaplib.IMAP4.close`, except
+that no messages are permanently removed from the currently
+selected mailbox. (Contributed by Dong-hee Na in :issue:`40375`.)
+
importlib
---------