[Python-checkins] python/dist/src/Doc/lib libsimplehttp.tex, 1.3, 1.3.38.1

[akuchling at users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8452

Modified Files:
      Tag: release23-branch
	libsimplehttp.tex 
Log Message:
Update docs to match module; various minor edits (copy of rev. 1.5)

Index: libsimplehttp.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libsimplehttp.tex,v
retrieving revision 1.3
retrieving revision 1.3.38.1
diff -C2 -d -r1.3 -r1.3.38.1
*** libsimplehttp.tex	1 Dec 2000 15:25:23 -0000	1.3
--- libsimplehttp.tex	7 Aug 2004 19:12:54 -0000	1.3.38.1
***************
*** 9,25 ****
  
  The \module{SimpleHTTPServer} module defines a request-handler class,
! interface compatible with \class{BaseHTTPServer.BaseHTTPRequestHandler}
! which serves files only from a base directory.
  
  The \module{SimpleHTTPServer} module defines the following class:
  
  \begin{classdesc}{SimpleHTTPRequestHandler}{request, client_address, server}
! This class is used, to serve files from current directory and below,
  directly mapping the directory structure to HTTP requests.
  
! A lot of the work is done by the base class
! \class{BaseHTTPServer.BaseHTTPRequestHandler}, such as parsing the
! request.  This class implements the \function{do_GET()} and
! \function{do_HEAD()} functions.
  \end{classdesc}
  
--- 9,24 ----
  
  The \module{SimpleHTTPServer} module defines a request-handler class,
! interface-compatible with \class{BaseHTTPServer.BaseHTTPRequestHandler},
! that serves files only from a base directory.
  
  The \module{SimpleHTTPServer} module defines the following class:
  
  \begin{classdesc}{SimpleHTTPRequestHandler}{request, client_address, server}
! This class is used to serve files from the current directory and below,
  directly mapping the directory structure to HTTP requests.
  
! A lot of the work, such as parsing the request, is done by the base
! class \class{BaseHTTPServer.BaseHTTPRequestHandler}.  This class
! implements the \function{do_GET()} and \function{do_HEAD()} functions.
  \end{classdesc}
  
***************
*** 33,38 ****
  
  \begin{memberdesc}{extensions_map}
! A dictionary mapping suffixes into MIME types. Default is signified
! by an empty string, and is considered to be \code{text/plain}.
  The mapping is used case-insensitively, and so should contain only
  lower-cased keys.
--- 32,37 ----
  
  \begin{memberdesc}{extensions_map}
! A dictionary mapping suffixes into MIME types. The default is signified
! by an empty string, and is considered to be \code{application/octet-stream}.
  The mapping is used case-insensitively, and so should contain only
  lower-cased keys.
***************
*** 44,48 ****
  This method serves the \code{'HEAD'} request type: it sends the
  headers it would send for the equivalent \code{GET} request. See the
! \method{do_GET()} method for more complete explanation of the possible
  headers.
  \end{methoddesc}
--- 43,47 ----
  This method serves the \code{'HEAD'} request type: it sends the
  headers it would send for the equivalent \code{GET} request. See the
! \method{do_GET()} method for a more complete explanation of the possible
  headers.
  \end{methoddesc}
***************
*** 52,64 ****
  a path relative to the current working directory.
  
! If the request was mapped to a directory, a \code{403} respond is output,
! followed by the explanation \code{'Directory listing not supported'}.
! Any \exception{IOError} exception in opening the requested file, is mapped
! to a \code{404}, \code{'File not found'} error. Otherwise, the content
! type is guessed using the \var{extensions_map} variable.
  
! A \code{'Content-type:'} with the guessed content type is output, and
! then a blank line, signifying end of headers, and then the contents of
! the file. The file is always opened in binary mode.
  
  For example usage, see the implementation of the \function{test()}
--- 51,73 ----
  a path relative to the current working directory.
  
! If the request was mapped to a directory, the directory is checked for
! a file named \code{index.html} or \code{index.htm} (in that order).
! If found, the file's contents are returned; otherwise a directory
! listing is generated by calling the \method{list_directory()} method.
! This method uses \function{os.listdir()} to scan the directory, and
! returns a \code{404} error response if the \function{listdir()} fails.
  
! If the request was mapped to a file, it is opened and the contents are
! returned.  Any \exception{IOError} exception in opening the requested
! file is mapped to a \code{404}, \code{'File not found'}
! error. Otherwise, the content type is guessed by calling the
! \method{guess_type()} method, which in turn uses the
! \var{extensions_map} variable.
! 
! A \code{'Content-type:'} header with the guessed content type is
! output, followed by a blank line signifying the end of the headers,
! and then the contents of the file are output. If the file's MIME type
! starts with \code{text/} the file is opened in text mode; otherwise
! binary mode is used.
  
  For example usage, see the implementation of the \function{test()}