]> granicus.if.org Git - python/commitdiff
Wordsmithing
authorAndrew M. Kuchling <amk@amk.ca>
Tue, 13 Jul 2004 14:03:31 +0000 (14:03 +0000)
committerAndrew M. Kuchling <amk@amk.ca>
Tue, 13 Jul 2004 14:03:31 +0000 (14:03 +0000)
Doc/lib/liburllib.tex

index c411cc86efb565236c9b7f2c5f2c0d8ce0254cf5..b25c7a4a99811739547404965c5286c6a63a40c8 100644 (file)
@@ -329,21 +329,21 @@ returned data is HTML, you can use the module
 \refmodule{htmllib}\refstmodindex{htmllib} to parse it.
 
 \item
-The code handling the FTP\index{FTP} protocol cannot differentiate between a
-file and a directory and can lead to unexpected behavior when attempting to
-read a URL that points to a file that is not accessible.
-If the URL ends in a \code{/} then it is assumed to be a
-directory and will be handled as such only.  But if an attempt to read a file
-leads to a 550 error (signaling the URL cannot be found or is not accessible,
-often for permission reasons), then the path is treated as a directory in order
-to handle the case of when a directory is specified by a URL but a trailing
-\code{/} is left off.
-This can lead to the apparent successful fetching of a file whose read
-permissions you do not have by still succeeding by returning the directory
-listing for the file from treating it as a directory.
-If more fine-grained control is needed, consider using the \module{ftplib}
-module, subclassing \class{FancyURLOpener}, or changing \var{_urlopener} to
-meet your needs.
+The code handling the FTP\index{FTP} protocol cannot differentiate
+between a file and a directory.  This can lead to unexpected behavior
+when attempting to read a URL that points to a file that is not
+accessible.  If the URL ends in a \code{/}, it is assumed to refer to
+a directory and will be handled accordingly.  But if an attempt to
+read a file leads to a 550 error (meaning the URL cannot be found or
+is not accessible, often for permission reasons), then the path is
+treated as a directory in order to handle the case when a directory is
+specified by a URL but the trailing \code{/} has been left off.  This can
+cause misleading results when you try to fetch a file whose read
+permissions make it inaccessible; the FTP code will try to read it,
+fail with a 550 error, and then perform a directory listing for the
+unreadable file. If fine-grained control is needed, consider using the
+\module{ftplib} module, subclassing \class{FancyURLOpener}, or changing
+\var{_urlopener} to meet your needs.
 
 \item
 This module does not support the use of proxies which require