summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndrew M. Kuchling <amk@amk.ca>2004-07-13 14:03:31 (GMT)
committerAndrew M. Kuchling <amk@amk.ca>2004-07-13 14:03:31 (GMT)
commit2a510ce119505b8345a0a3d6767caf0e2a8f6f7b (patch)
treeff2982bc444431e0fee4236204d0d25e5da1f31c
parentee86a66dd87787e54772c93c961fa611311b1502 (diff)
downloadcpython-2a510ce119505b8345a0a3d6767caf0e2a8f6f7b.zip
cpython-2a510ce119505b8345a0a3d6767caf0e2a8f6f7b.tar.gz
cpython-2a510ce119505b8345a0a3d6767caf0e2a8f6f7b.tar.bz2
Wordsmithing
-rw-r--r--Doc/lib/liburllib.tex30
1 files changed, 15 insertions, 15 deletions
diff --git a/Doc/lib/liburllib.tex b/Doc/lib/liburllib.tex
index c411cc8..b25c7a4 100644
--- a/Doc/lib/liburllib.tex
+++ b/Doc/lib/liburllib.tex
@@ -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