[Python-checkins] CVS: python/dist/src/Doc/lib distutils.tex,NONE,1.1.2.1 lib.tex,1.189,1.189.2.1 libanydbm.tex,1.18,1.18.14.1 libexcs.tex,1.38,1.38.2.1 libfuncs.tex,1.80,1.80.2.1 libos.tex,1.60.2.1,1.60.2.2 libre.tex,1.63,1.63.2.1 libsched.tex,1.5,1.5.6.1 libstdtypes.tex,1.64,1.64.2.1 libsys.tex,1.46.4.1,1.46.4.2 liburllib.tex,1.36,1.36.2.1

Tim Peters tim_one@users.sourceforge.net
Fri, 27 Jul 2001 22:03:01 -0700


Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv14630/descr/dist/src/Doc/lib

Modified Files:
      Tag: descr-branch
	lib.tex libanydbm.tex libexcs.tex libfuncs.tex libos.tex 
	libre.tex libsched.tex libstdtypes.tex libsys.tex 
	liburllib.tex 
Added Files:
      Tag: descr-branch
	distutils.tex 
Log Message:
Merge of trunk tags date2001-07-21 to date2001-07-28.


--- NEW FILE: distutils.tex ---
\section{\module{distutils} ---
         Building and installing Python modules}

\declaremodule{standard}{distutils}
\modulesynopsis{Support for building and installing Python modules
                into an existing Python installation.}
\sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}


The \module{distutils} package provides support for building and
installing additional modules into a Python installation.  The new
modules may be either 100\%{}-pure Python, or may be extension modules
written in C, or may be collections of Python packages which include
modules coded in both Python and C.

This package is discussed in two separate documents which are included
in the Python documentation package.  To learn about distributing new
modules using the \module{distutils} facilities, read
\citetitle[../dist/dist.html]{Distributing Python Modules}.  To learn
about installing Python modules, whether or not the author made use of
the \module{distutils} package, read
\citetitle[../inst/inst.html]{Installing Python Modules}.


\begin{seealso}
  \seetitle[../dist/dist.html]{Distributing Python Modules}{The manual
            for developers and packagers of Python modules.  This
            describes how to prepare \module{distutils}-based packages
            so that they may be easily installed into an existing
            Python installaion.}

  \seetitle[../inst/inst.html]{Installing Python Modules}{An
            ``administrators'' manual which includes information on
            installing modules into an existing Python installation.
            You do not need to be a Python programmer to read this
            manual.}
\end{seealso}

Index: lib.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/lib.tex,v
retrieving revision 1.189
retrieving revision 1.189.2.1
diff -C2 -d -r1.189 -r1.189.2.1
*** lib.tex	2001/07/14 02:50:55	1.189
--- lib.tex	2001/07/28 05:02:58	1.189.2.1
***************
*** 282,285 ****
--- 282,286 ----
  \input{libcompileall}
  \input{libdis}
+ \input{distutils}
  
  %\input{libamoeba}              % AMOEBA ONLY

Index: libanydbm.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libanydbm.tex,v
retrieving revision 1.18
retrieving revision 1.18.14.1
diff -C2 -d -r1.18 -r1.18.14.1
*** libanydbm.tex	1999/04/19 21:19:21	1.18
--- libanydbm.tex	2001/07/28 05:02:58	1.18.14.1
***************
*** 49,53 ****
  
  \begin{seealso}
-   \seemodule{anydbm}{Generic interface to \code{dbm}-style databases.}
    \seemodule{dbhash}{BSD \code{db} database interface.}
    \seemodule{dbm}{Standard \UNIX{} database interface.}
--- 49,52 ----

Index: libexcs.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libexcs.tex,v
retrieving revision 1.38
retrieving revision 1.38.2.1
diff -C2 -d -r1.38 -r1.38.2.1
*** libexcs.tex	2001/07/12 02:09:51	1.38
--- libexcs.tex	2001/07/28 05:02:58	1.38.2.1
***************
*** 67,72 ****
  \begin{excdesc}{StandardError}
  The base class for all built-in exceptions except
! \exception{SystemExit}.  \exception{StandardError} itself is derived
! from the root class
  \exception{Exception}.
  \end{excdesc}
--- 67,72 ----
  \begin{excdesc}{StandardError}
  The base class for all built-in exceptions except
! \exception{StopIteration} and \exception{SystemExit}.
! \exception{StandardError} itself is derived from the root class
  \exception{Exception}.
  \end{excdesc}
***************
*** 141,145 ****
    with the \longprogramopt{with-fpectl} option, or the
    \constant{WANT_SIGFPE_HANDLER} symbol is defined in the
!   \file{config.h} file.
  \end{excdesc}
  
--- 141,145 ----
    with the \longprogramopt{with-fpectl} option, or the
    \constant{WANT_SIGFPE_HANDLER} symbol is defined in the
!   \file{pyconfig.h} file.
  \end{excdesc}
  
***************
*** 296,300 ****
    running the risk of losing control.  The \function{os._exit()} function
    can be used if it is absolutely positively necessary to exit
!   immediately (e.g., after a \function{fork()} in the child process).
  \end{excdesc}
  
--- 296,301 ----
    running the risk of losing control.  The \function{os._exit()} function
    can be used if it is absolutely positively necessary to exit
!   immediately (for example, in the child process after a call to
!   \function{fork()}).
  \end{excdesc}
  

Index: libfuncs.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libfuncs.tex,v
retrieving revision 1.80
retrieving revision 1.80.2.1
diff -C2 -d -r1.80 -r1.80.2.1
*** libfuncs.tex	2001/07/12 11:27:16	1.80
--- libfuncs.tex	2001/07/28 05:02:58	1.80.2.1
***************
*** 339,345 ****
    Otherwise, the argument may be a plain or
    long integer or a floating point number.  Conversion of floating
!   point numbers to integers is defined by the C semantics; normally
!   the conversion truncates towards zero.\footnote{This is ugly --- the
!   language definition should require truncation towards zero.}
  \end{funcdesc}
  
--- 339,343 ----
    Otherwise, the argument may be a plain or
    long integer or a floating point number.  Conversion of floating
!   point numbers to integers truncates (towards zero).
  \end{funcdesc}
  

Index: libos.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libos.tex,v
retrieving revision 1.60.2.1
retrieving revision 1.60.2.2
diff -C2 -d -r1.60.2.1 -r1.60.2.2
*** libos.tex	2001/07/18 04:13:56	1.60.2.1
--- libos.tex	2001/07/28 05:02:58	1.60.2.2
***************
*** 996,1000 ****
  absolute path, make sure the first character is not a slash
  (\character{/}); the underlying Win32 \cfunction{ShellExecute()}
! function doesn't work it is.  Use the \function{os.path.normpath()}
  function to ensure that the path is properly encoded for Win32.
  Availability: Windows.
--- 996,1000 ----
  absolute path, make sure the first character is not a slash
  (\character{/}); the underlying Win32 \cfunction{ShellExecute()}
! function doesn't work if it is.  Use the \function{os.path.normpath()}
  function to ensure that the path is properly encoded for Win32.
  Availability: Windows.

Index: libre.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libre.tex,v
retrieving revision 1.63
retrieving revision 1.63.2.1
diff -C2 -d -r1.63 -r1.63.2.1
*** libre.tex	2001/07/12 14:13:43	1.63
--- libre.tex	2001/07/28 05:02:58	1.63.2.1
***************
*** 97,104 ****
  \constant{MULTILINE} mode also matches immediately after each newline.
  
! \item[\character{\$}] Matches the end of the string, and in
! \constant{MULTILINE} mode also matches before a newline.
! \regexp{foo} matches both 'foo' and 'foobar', while the regular
! expression \regexp{foo\$} matches only 'foo'.
  
  \item[\character{*}] Causes the resulting RE to
--- 97,107 ----
  \constant{MULTILINE} mode also matches immediately after each newline.
  
! \item[\character{\$}] Matches the end of the string or just before the
! newline at the end of the string, and in \constant{MULTILINE} mode
! also matches before a newline.  \regexp{foo} matches both 'foo' and
! 'foobar', while the regular expression \regexp{foo\$} matches only
! 'foo'.  More interestingly, searching for \regexp{foo\e d} in
! 'foo1\textbackslash nfoo2\textbackslash n' matches 'foo2' normally,
! but 'foo1' in \constant{MULTILINE} mode.
  
  \item[\character{*}] Causes the resulting RE to

Index: libsched.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libsched.tex,v
retrieving revision 1.5
retrieving revision 1.5.6.1
diff -C2 -d -r1.5 -r1.5.6.1
*** libsched.tex	2000/12/01 15:25:23	1.5
--- libsched.tex	2001/07/28 05:02:58	1.5.6.1
***************
*** 56,62 ****
  \var{priority}.
  
! Executing the event means executing \code{apply(\var{action},
! \var{argument})}.  \var{argument} must be a tuple holding the
! parameters for \var{action}.
  
  Return value is an event which may be used for later cancellation of
--- 56,62 ----
  \var{priority}.
  
! Executing the event means executing
! \code{\var{action}(*\var{argument})}.  \var{argument} must be a
! sequence holding the parameters for \var{action}.
  
  Return value is an event which may be used for later cancellation of

Index: libstdtypes.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libstdtypes.tex,v
retrieving revision 1.64
retrieving revision 1.64.2.1
diff -C2 -d -r1.64 -r1.64.2.1
*** libstdtypes.tex	2001/07/06 20:30:11	1.64
--- libstdtypes.tex	2001/07/28 05:02:58	1.64.2.1
***************
*** 331,335 ****
  
  \begin{methoddesc}[container]{__iter__}{}
!   Return an interator object.  The object is required to support the
    iterator protocol described below.  If a container supports
    different types of iteration, additional methods can be provided to
--- 331,335 ----
  
  \begin{methoddesc}[container]{__iter__}{}
!   Return an iterator object.  The object is required to support the
    iterator protocol described below.  If a container supports
    different types of iteration, additional methods can be provided to
***************
*** 857,862 ****
  \item[(5)] The \method{sort()} and \method{reverse()} methods modify the
    list in place for economy of space when sorting or reversing a large
!   list.  They don't return the sorted or reversed list to remind you
!   of this side effect.
  
  \item[(6)] The \method{sort()} method takes an optional argument
--- 857,862 ----
  \item[(5)] The \method{sort()} and \method{reverse()} methods modify the
    list in place for economy of space when sorting or reversing a large
!   list.  To remind you that they operate by side effect, they don't return
!   the sorted or reversed list.
  
  \item[(6)] The \method{sort()} method takes an optional argument

Index: libsys.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libsys.tex,v
retrieving revision 1.46.4.1
retrieving revision 1.46.4.2
diff -C2 -d -r1.46.4.1 -r1.46.4.2
*** libsys.tex	2001/07/21 06:07:12	1.46.4.1
--- libsys.tex	2001/07/28 05:02:58	1.46.4.2
***************
*** 130,134 ****
    \longprogramopt{exec-prefix} argument to the \program{configure}
    script.  Specifically, all configuration files (e.g. the
!   \file{config.h} header file) are installed in the directory
    \code{exec_prefix + '/lib/python\var{version}/config'}, and shared
    library modules are installed in \code{exec_prefix +
--- 130,134 ----
    \longprogramopt{exec-prefix} argument to the \program{configure}
    script.  Specifically, all configuration files (e.g. the
!   \file{pyconfig.h} header file) are installed in the directory
    \code{exec_prefix + '/lib/python\var{version}/config'}, and shared
    library modules are installed in \code{exec_prefix +
***************
*** 299,303 ****
    script.  The main collection of Python library modules is installed
    in the directory \code{prefix + '/lib/python\var{version}'} while
!   the platform independent header files (all except \file{config.h})
    are stored in \code{prefix + '/include/python\var{version}'}, where
    \var{version} is equal to \code{version[:3]}.
--- 299,303 ----
    script.  The main collection of Python library modules is installed
    in the directory \code{prefix + '/lib/python\var{version}'} while
!   the platform independent header files (all except \file{pyconfig.h})
    are stored in \code{prefix + '/include/python\var{version}'}, where
    \var{version} is equal to \code{version[:3]}.

Index: liburllib.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/liburllib.tex,v
retrieving revision 1.36
retrieving revision 1.36.2.1
diff -C2 -d -r1.36 -r1.36.2.1
*** liburllib.tex	2001/07/14 02:50:55	1.36
--- liburllib.tex	2001/07/28 05:02:58	1.36.2.1
***************
*** 176,180 ****
      def __init__(self, *args):
          self.version = "App/1.7"
!         apply(urllib.FancyURLopener.__init__, (self,) + args)
  
  urllib._urlopener = AppURLopener()
--- 176,180 ----
      def __init__(self, *args):
          self.version = "App/1.7"
!         urllib.FancyURLopener.__init__(self, *args)
  
  urllib._urlopener = AppURLopener()