[Python-checkins] python/dist/src/Doc/dist dist.tex,1.36.16.3,1.36.16.4
nnorwitz@users.sourceforge.net
nnorwitz@users.sourceforge.net
Tue, 01 Jul 2003 14:37:40 -0700
Update of /cvsroot/python/python/dist/src/Doc/dist
In directory sc8-pr-cvs1:/tmp/cvs-serv9604/Doc/dist
Modified Files:
Tag: release22-maint
dist.tex
Log Message:
Backport theller's checkin:
Document the DISTUTILS_DEBUG variable.
Closes sf #761401.
Index: dist.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/dist/dist.tex,v
retrieving revision 1.36.16.3
retrieving revision 1.36.16.4
diff -C2 -d -r1.36.16.3 -r1.36.16.4
*** dist.tex 31 Mar 2003 16:45:22 -0000 1.36.16.3
--- dist.tex 1 Jul 2003 21:37:38 -0000 1.36.16.4
***************
*** 664,667 ****
--- 664,688 ----
+ \subsection{Debugging the setup script}
+ \label{meta-data}
+
+ Sometimes things go wrong, and the setup script doesn't do what the
+ developer wants.
+
+ Distutils catches any exceptions when running the setup script, and
+ print a simple error message before the script is terminated. The
+ motivation for this behaviour is to not confuse administrators who
+ don't know much about Python and are trying to install a package. If
+ they get a big long traceback from deep inside the guts of Distutils,
+ they may think the package or the Python installation is broken
+ because they don't read all the way down to the bottom and see that
+ it's a permission problem.
+
+ On the other hand, this doesn't help the developer to find the cause
+ of the failure. For this purpose, the DISTUTILS_DEBUG environment
+ variable can be set to anything except an empty string, and distutils
+ will now print detailed information what it is doing, and prints the
+ full traceback in case an exception occurrs.
+
\section{Writing the Setup Configuration File}
\label{setup-config}