[Python-checkins] python/nondist/sandbox/distutilsref distref.tex,1.9,1.10
anthonybaxter@users.sourceforge.net
anthonybaxter@users.sourceforge.net
2003年6月12日 21:32:18 -0700
Update of /cvsroot/python/python/nondist/sandbox/distutilsref
In directory sc8-pr-cvs1:/tmp/cvs-serv3316
Modified Files:
distref.tex
Log Message:
env vars
Index: distref.tex
===================================================================
RCS file: /cvsroot/python/python/nondist/sandbox/distutilsref/distref.tex,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -d -r1.9 -r1.10
*** distref.tex 26 May 2003 08:00:36 -0000 1.9
--- distref.tex 13 Jun 2003 04:32:15 -0000 1.10
***************
*** 1375,1378 ****
--- 1375,1380 ----
\modulesynopsis{implements classes that represent module version numbers. }
+ % todo
+
\subsection{Distutils Commands}
***************
*** 1416,1419 ****
--- 1418,1422 ----
\subsubsection{Individual Distutils commands}
+ % todo
\subsubsection{\module{distutils.command.bdist} -- Build a binary installer}
***************
*** 1421,1424 ****
--- 1424,1428 ----
\modulesynopsis{Build a binary installer for a package}
+ % todo
\subsubsection{\module{distutils.command.bdist_packager} -- Abstract base class for packagers}
***************
*** 1426,1429 ****
--- 1430,1434 ----
\modulesynopsis{Abstract base class for packagers}
+ % todo
\subsubsection{\module{distutils.command.bdist_dumb} -- Build a "dumb" installer}
***************
*** 1431,1434 ****
--- 1436,1440 ----
\modulesynopsis{Build a "dumb" installer - a simple archive of files}
+ % todo
%\subsubsection{\module{} -- }
***************
*** 1446,1449 ****
--- 1452,1456 ----
\modulesynopsis{Build a binary distribution as a Redhat RPM and SRPM}
+ % todo
\subsubsection{\module{distutils.command.bdist_wininst} -- Build a Windows installer}
***************
*** 1451,1454 ****
--- 1458,1462 ----
\modulesynopsis{Build a Windows installer}
+ % todo
\subsubsection{\module{distutils.command.sdist} -- Build a source distribution}
***************
*** 1456,1459 ****
--- 1464,1468 ----
\modulesynopsis{Build a source distribution}
+ % todo
\subsubsection{\module{distutils.command.build} -- Build all files of a package}
***************
*** 1461,1464 ****
--- 1470,1474 ----
\modulesynopsis{Build all files of a package}
+ % todo
\subsubsection{\module{distutils.command.build_clib} -- Build any C libraries in a package}
***************
*** 1466,1469 ****
--- 1476,1480 ----
\modulesynopsis{Build any C libraries in a package}
+ % todo
\subsubsection{\module{distutils.command.build_ext} -- Build any extensions in a package}
***************
*** 1471,1474 ****
--- 1482,1486 ----
\modulesynopsis{Build any extensions in a package}
+ % todo
\subsubsection{\module{distutils.command.build_py} -- Build the .py/.pyc files of a package}
***************
*** 1476,1479 ****
--- 1488,1492 ----
\modulesynopsis{Build the .py/.pyc files of a package}
+ % todo
\subsubsection{\module{distutils.command.build_scripts} -- Build the scripts of a package}
***************
*** 1481,1484 ****
--- 1494,1498 ----
\modulesynopsis{Build the scripts of a package}
+ % todo
\subsubsection{\module{distutils.command.clean} -- Clean a package build area}
***************
*** 1486,1489 ****
--- 1500,1504 ----
\modulesynopsis{Clean a package build area}
+ % todo
\subsubsection{\module{distutils.command.config} -- Perform package configuration}
***************
*** 1491,1494 ****
--- 1506,1510 ----
\modulesynopsis{Perform package configuration}
+ % todo
\subsubsection{\module{distutils.command.install} -- Install a package}
***************
*** 1496,1499 ****
--- 1512,1516 ----
\modulesynopsis{Install a package}
+ % todo
\subsubsection{\module{distutils.command.install_data} -- Install data files from a package}
***************
*** 1501,1504 ****
--- 1518,1522 ----
\modulesynopsis{Install data files from a package}
+ % todo
\subsubsection{\module{distutils.command.install_headers} -- Install C/C++ header files from a package}
***************
*** 1506,1509 ****
--- 1524,1528 ----
\modulesynopsis{Install C/C++ header files from a package}
+ % todo
\subsubsection{\module{distutils.command.install_lib} -- Install library files from a package}
***************
*** 1511,1514 ****
--- 1530,1534 ----
\modulesynopsis{Install library files from a package}
+ % todo
\subsubsection{\module{distutils.command.install_scripts} -- Install script files from a package}
***************
*** 1516,1519 ****
--- 1536,1540 ----
\modulesynopsis{Install script files from a package}
+ % todo
\subsubsection{\module{distutils.command.register} -- Register a module with the Python Package Index}
***************
*** 1523,1526 ****
--- 1544,1548 ----
The \code{register} command registers the package with the Python Package
Index. This is described in more detail in \pep{301}.
+ % todo
\subsubsection{Creating a new Distutils command}
***************
*** 1583,1585 ****
--- 1605,1625 ----
predicates can be unbound methods, so they must already have been
defined. The canonical example is the \code{install} command.
+
+ \subsection{Running setup.py scripts}
+
+ In this section, some documentation about how to run a distutils setup.py
+ to set various flags.
+
+ \subsubsection{Environment Variables}
+
+ The following environment variables can be used to adjust distutils behaviour.
+
+ \begin{tableii}{c|l}{environment variable}{environment variable}{description}
+ \lineii{CC}{The name of the C compiler (used for .c files)}
+ \lineii{CXX}{The name of the C++ compiler (used for .cxx files)}
+ \lineii{CPP}{The name of the C pre-processor}
+ \lineii{CFLAGS}{Additional options for the C compiler}
+ \lineii{CPPFLAGS}{Additional pre-processor options}
+ \lineii{LDFLAGS}{Additional options for the linker}
+ \end{tableii}