diff options
| author | Raymond Hettinger <python@rcn.com> | 2011-01-30 08:20:37 (GMT) |
|---|---|---|
| committer | Raymond Hettinger <python@rcn.com> | 2011-01-30 08:20:37 (GMT) |
| commit | ce227e3518ccc8ed26e4befdbb883c24517ba858 (patch) | |
| tree | 3efdc1abd5eb5c6b29529cc3e1b8056e3edebef2 /Doc/whatsnew/3.2.rst | |
| parent | d163c2c57b10908ef787dda8dbd68db2068df692 (diff) | |
| download | cpython-ce227e3518ccc8ed26e4befdbb883c24517ba858.zip cpython-ce227e3518ccc8ed26e4befdbb883c24517ba858.tar.gz cpython-ce227e3518ccc8ed26e4befdbb883c24517ba858.tar.bz2 | |
Clarify the status of get_string() and recommend using the binary API.
Diffstat (limited to 'Doc/whatsnew/3.2.rst')
| -rw-r--r-- | Doc/whatsnew/3.2.rst | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst index 26d6539..05d8d21 100644 --- a/Doc/whatsnew/3.2.rst +++ b/Doc/whatsnew/3.2.rst @@ -2169,8 +2169,13 @@ the file to text-mode). There is also a new :meth:`~mailbox.Mailbox.get_bytes` method that returns a :class:`bytes` representation of a message corresponding to a given *key*. -(Contributed by R. David Murray with efforts from Steffen Daode Nurpmeso and -Victor Stinner in :issue:`9124`.) +It is still possible to get non-binary output using the old API's +:meth:`~mailbox.Mailbox.get_string` method, but that approach +is not very useful. Instead, it is best to extract messages from +a :class:`~mailbox.Message` object or to load them from binary input. + +(Contributed by R. David Murray, with efforts from Steffen Daode Nurpmeso and an +initial patch by Victor Stinner in :issue:`9124`.) turtledemo ---------- |