[Python-checkins] cpython (merge 3.5 -> default): Issue #11072: change the incorrect "deprecation" of ftplib dir() and nlst()
gregory.p.smith
python-checkins at python.org
Mon Dec 14 01:11:04 EST 2015
https://hg.python.org/cpython/rev/287bb82768a7
changeset: 99572:287bb82768a7
parent: 99569:41717421b134
parent: 99571:ecef6b3f6639
user: Gregory P. Smith <greg at krypto.org>
date: Sun Dec 13 22:10:58 2015 -0800
summary:
Issue #11072: change the incorrect "deprecation" of ftplib dir() and nlst()
APIs into a note that mlsd() is a nicer API if the server supports
it. They aren't deprecated, they are all different server commands.
Not all servers support all commands.
files:
Doc/library/ftplib.rst | 6 +++---
1 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/Doc/library/ftplib.rst b/Doc/library/ftplib.rst
--- a/Doc/library/ftplib.rst
+++ b/Doc/library/ftplib.rst
@@ -314,7 +314,7 @@
.. method:: FTP.mlsd(path="", facts=[])
- List a directory in a standardized format by using MLSD command
+ List a directory in a standardized format by using ``MLSD`` command
(:rfc:`3659`). If *path* is omitted the current directory is assumed.
*facts* is a list of strings representing the type of information desired
(e.g. ``["type", "size", "perm"]``). Return a generator object yielding a
@@ -333,7 +333,7 @@
directory). Multiple arguments can be used to pass non-standard options to
the ``NLST`` command.
- .. deprecated:: 3.3 use :meth:`mlsd` instead.
+ .. note:: If your server supports the command, :meth:`mlsd` offers a better API.
.. method:: FTP.dir(argument[, ...])
@@ -345,7 +345,7 @@
as a *callback* function as for :meth:`retrlines`; the default prints to
``sys.stdout``. This method returns ``None``.
- .. deprecated:: 3.3 use :meth:`mlsd` instead.
+ .. note:: If your server supports the command, :meth:`mlsd` offers a better API.
.. method:: FTP.rename(fromname, toname)
--
Repository URL: https://hg.python.org/cpython
More information about the Python-checkins
mailing list