changeset:   99571:ecef6b3f6639
branch:      3.5
parent:      99568:014e6f7d7c1a
user:        Gregory P. Smith <greg@krypto.org>
date:        Sun Dec 13 22:10:28 2015 -0800
files:       Doc/library/ftplib.rst
description:
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.


diff -r 014e6f7d7c1a -r ecef6b3f6639 Doc/library/ftplib.rst
--- a/Doc/library/ftplib.rst	Sun Dec 13 20:09:42 2015 -0800
+++ b/Doc/library/ftplib.rst	Sun Dec 13 22:10:28 2015 -0800
@@ -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)