[Python-checkins] python/dist/src/Doc/lib liburllib.tex,1.53,1.54

Tue Jul 13 16:03:35 CEST 2004

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv13357
Modified Files:
	liburllib.tex 
Log Message:
Wordsmithing
Index: liburllib.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/liburllib.tex,v
retrieving revision 1.53
retrieving revision 1.54
diff -C2 -d -r1.53 -r1.54
*** liburllib.tex	13 Jul 2004 00:48:42 -0000	1.53
--- liburllib.tex	13 Jul 2004 14:03:31 -0000	1.54
***************
*** 330,348 ****

 \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.

 \item
--- 330,348 ----

 \item
! 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