diff options
| author | Dong-hee Na <donghee.na92@gmail.com> | 2020-01-23 06:59:43 +0900 |
|---|---|---|
| committer | Berker Peksag <berker.peksag@gmail.com> | 2020-01-23 00:59:43 +0300 |
| commit | 1f0f102dec506fd06f912b74dd2be64a7fba0d3f (patch) | |
| tree | dfdfd1335254a0f0172995d452f1b55f726ac065 /Doc | |
| parent | b477d19a6b7751b0c933b239dae4fc96dbcde9c4 (diff) | |
| download | cpython-git-1f0f102dec506fd06f912b74dd2be64a7fba0d3f.tar.gz | |
bpo-39366: Remove xpath() and xgtitle() methods of NNTP (GH-18035)
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/nntplib.rst | 27 | ||||
| -rw-r--r-- | Doc/whatsnew/3.9.rst | 7 |
2 files changed, 7 insertions, 27 deletions
diff --git a/Doc/library/nntplib.rst b/Doc/library/nntplib.rst index 7697365152..e7ec9047e0 100644 --- a/Doc/library/nntplib.rst +++ b/Doc/library/nntplib.rst @@ -542,33 +542,6 @@ them have been superseded by newer commands in :rfc:`3977`. if available. -.. method:: NNTP.xpath(id) - - Return a pair ``(resp, path)``, where *path* is the directory path to the - article with message ID *id*. Most of the time, this extension is not - enabled by NNTP server administrators. - - .. deprecated:: 3.3 - The XPATH extension is not actively used. - - -.. XXX deprecated: - - .. method:: NNTP.xgtitle(name, *, file=None) - - Process an ``XGTITLE`` command, returning a pair ``(response, list)``, where - *list* is a list of tuples containing ``(name, title)``. If the *file* parameter - is supplied, then the output of the ``XGTITLE`` command is stored in a file. - If *file* is a string, then the method will open a file with that name, write - to it then close it. If *file* is a :term:`file object`, then it will start - calling :meth:`write` on it to store the lines of the command output. If *file* - is supplied, then the returned *list* is an empty list. This is an optional NNTP - extension, and may not be supported by all servers. - - :rfc:`2980` says "It is suggested that this extension be deprecated". Use - :meth:`descriptions` or :meth:`description` instead. - - Utility functions ----------------- diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst index f5835d6851..d9c545adc4 100644 --- a/Doc/whatsnew/3.9.rst +++ b/Doc/whatsnew/3.9.rst @@ -363,6 +363,13 @@ Deprecated Removed ======= +* :class:`nntplib.NNTP`: ``xpath()`` and ``xgtitle()`` methods have been removed. + These methods are deprecated since Python 3.3. Generally, these extensions + are not supported or not enabled by NNTP server administrators. + For ``xgtitle()``, please use :meth:`nntplib.NNTP.descriptions` or + :meth:`nntplib.NNTP.description` instead. + (Contributed by Dong-hee Na in :issue:`39366`.) + * :class:`array.array`: ``tostring()`` and ``fromstring()`` methods have been removed. They were aliases to ``tobytes()`` and ``frombytes()``, deprecated since Python 3.2. |