summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2015-05-16 19:05:53 (GMT)
committerR David Murray <rdmurray@bitdance.com>2015-05-16 19:05:53 (GMT)
commitb8cd3e4e30d3219ecf00ce7f114a15746561ea87 (patch)
tree062ec0ea886b1015e47f932d4676ee2dced7c85d /Doc
parent8eb1f077c2be03f72ef31ddd2cfe805ffbfbd524 (diff)
downloadcpython-b8cd3e4e30d3219ecf00ce7f114a15746561ea87.zip
cpython-b8cd3e4e30d3219ecf00ce7f114a15746561ea87.tar.gz
cpython-b8cd3e4e30d3219ecf00ce7f114a15746561ea87.tar.bz2
#21804: Add RFC 6856 (UTF8) support to poplib.
Patch by Milan Oberkirch.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/poplib.rst9
-rw-r--r--Doc/whatsnew/3.5.rst7
2 files changed, 16 insertions, 0 deletions
diff --git a/Doc/library/poplib.rst b/Doc/library/poplib.rst
index 45baad9..fee6298 100644
--- a/Doc/library/poplib.rst
+++ b/Doc/library/poplib.rst
@@ -194,6 +194,15 @@ An :class:`POP3` instance has the following methods:
the unique id for that message in the form ``'response mesgnum uid``, otherwise
result is list ``(response, ['mesgnum uid', ...], octets)``.
+
+.. method:: POP3.utf8()
+
+ Try to switch to UTF-8 mode. Returns the server response if sucessful,
+ raises :class:`error_proto` if not. Specified in :RFC:`6856`.
+
+ .. versionadded:: 3.5
+
+
.. method:: POP3.stls(context=None)
Start a TLS session on the active connection as specified in :rfc:`2595`.
diff --git a/Doc/whatsnew/3.5.rst b/Doc/whatsnew/3.5.rst
index 86173a0..6411667 100644
--- a/Doc/whatsnew/3.5.rst
+++ b/Doc/whatsnew/3.5.rst
@@ -452,6 +452,13 @@ pickle
classes) now are supported with pickle protocols < 4.
(Contributed by Serhiy Storchaka in :issue:`23611`.)
+poplib
+------
+
+* A new command :meth:`~poplib.POP3.utf8` enables :rfc:`6856`
+ (internationalized email) support if the POP server supports it. (Contributed
+ by Milan OberKirch in :issue:`21804`.)
+
re
--