summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorÉric Araujo <merwok@netwok.org>2014-03-13 09:59:31 (GMT)
committerÉric Araujo <merwok@netwok.org>2014-03-13 09:59:31 (GMT)
commitf1e8c70cf0ba6082e9b35061c310d708d477556a (patch)
tree21129b346155d659cb9358c9d9d7ea5f5e48260d /Doc
parent39930c9ca0e8ad2e1465e7a31b4a400d6f34ccff (diff)
parent45fc8713bda1bfd6c0de3c6f493a4eeff52acbe3 (diff)
downloadcpython-f1e8c70cf0ba6082e9b35061c310d708d477556a.zip
cpython-f1e8c70cf0ba6082e9b35061c310d708d477556a.tar.gz
cpython-f1e8c70cf0ba6082e9b35061c310d708d477556a.tar.bz2
Merge 3.3 (#11599)
Diffstat (limited to 'Doc')
-rw-r--r--Doc/distutils/setupscript.rst9
-rw-r--r--Doc/install/index.rst3
2 files changed, 8 insertions, 4 deletions
diff --git a/Doc/distutils/setupscript.rst b/Doc/distutils/setupscript.rst
index ee96302..fbe4290 100644
--- a/Doc/distutils/setupscript.rst
+++ b/Doc/distutils/setupscript.rst
@@ -685,6 +685,8 @@ include the following code fragment in your :file:`setup.py` before the
DistributionMetadata.download_url = None
+.. _debug-setup-script:
+
Debugging the setup script
==========================
@@ -700,7 +702,8 @@ 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
+failure. For this purpose, the :envvar:`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
-occurs.
+information about what it is doing, dump the full traceback when an exception
+occurs, and print the whole command line when an external program (like a C
+compiler) fails.
diff --git a/Doc/install/index.rst b/Doc/install/index.rst
index 779e923..0c9a9f2 100644
--- a/Doc/install/index.rst
+++ b/Doc/install/index.rst
@@ -58,7 +58,8 @@ new goodies to their toolbox. You don't need to know Python to read this
document; there will be some brief forays into using Python's interactive mode
to explore your installation, but that's it. If you're looking for information
on how to distribute your own Python modules so that others may use them, see
-the :ref:`distutils-index` manual.
+the :ref:`distutils-index` manual. :ref:`debug-setup-script` may also be of
+interest.
.. _inst-trivial-install: