]> granicus.if.org Git - python/commitdiff
Documented FTP.set_pasv().
authorFred Drake <fdrake@acm.org>
Thu, 18 Mar 1999 16:08:54 +0000 (16:08 +0000)
committerFred Drake <fdrake@acm.org>
Thu, 18 Mar 1999 16:08:54 +0000 (16:08 +0000)
Doc/lib/libftplib.tex

index 5840e83461f6b47f6424ac82e40bfaab4e546a02..45e65baf763b76dd7b01f5a3d00fb0aecb872f29 100644 (file)
@@ -1,19 +1,17 @@
 \section{\module{ftplib} ---
-         FTP protocol client.}
-\declaremodule{standard}{ftplib}
+         FTP protocol client}
 
+\declaremodule{standard}{ftplib}
 \modulesynopsis{FTP protocol client (requires sockets).}
 
-\indexii{FTP}{protocol}
-
 
 This module defines the class \class{FTP} and a few related items.
-The \class{FTP} class implements the client side of the FTP protocol.
-You can use this to write Python programs that perform a variety of
-automated FTP jobs, such as mirroring other ftp servers.  It is also
-used by the module \module{urllib} to handle URLs that use FTP.  For
-more information on FTP (File Transfer Protocol), see Internet
-\rfc{959}.
+The \class{FTP} class implements the client side of the FTP
+protocol.\indexii{FTP}{protocol}  You can use this to write Python
+programs that perform a variety of automated FTP jobs, such as
+mirroring other ftp servers.  It is also used by the module
+\refmodule{urllib} to handle URLs that use FTP.  For more information
+on FTP (File Transfer Protocol), see Internet \rfc{959}.
 
 Here's a sample session using the \module{ftplib} module:
 
@@ -71,8 +69,7 @@ not begin with a digit in the range 1--5.
 \end{excdesc}
 
 
-\subsection{FTP Objects}
-\label{ftp-objects}
+\subsection{FTP Objects \label{ftp-objects}}
 
 \class{FTP} instances have the following methods:
 
@@ -104,7 +101,7 @@ information that may be relevant to the user.)
 Log in as the given \var{user}.  The \var{passwd} and \var{acct}
 parameters are optional and default to the empty string.  If no
 \var{user} is specified, it defaults to \code{'anonymous'}.  If
-\var{user} is \code{anonymous}, the default \var{passwd} is
+\var{user} is \code{'anonymous'}, the default \var{passwd} is
 \samp{\var{realuser}@\var{host}} where \var{realuser} is the real user
 name (glanced from the \envvar{LOGNAME} or \envvar{USER} environment
 variable) and \var{host} is the hostname as returned by
@@ -151,6 +148,11 @@ with the trailing CRLF stripped.  The default \var{callback} prints
 the line to \code{sys.stdout}.
 \end{methoddesc}
 
+\begin{methoddesc}{set_pasv}{boolean}
+Enable ``passive'' mode if \var{boolean} is true, other disable
+passive mode.
+\end{methoddesc}
+
 \begin{methoddesc}{storbinary}{command, file, blocksize}
 Store a file in binary transfer mode.  \var{command} should be an
 appropriate \samp{STOR} command, i.e.\ \code{"STOR \var{filename}"}.