[Python-checkins] devguide: Provide more clarification on running tests from the command-line.

Fri Nov 16 01:53:21 CET 2012

http://hg.python.org/devguide/rev/427bdf0cf72f
changeset: 567:427bdf0cf72f
user: Chris Jerdonek <chris.jerdonek at gmail.com>
date: Thu Nov 15 16:52:11 2012 -0800
summary:
 Provide more clarification on running tests from the command-line.
This change is partly in response to the python-dev thread starting with
the following post (subject line "problems building python2.7"):
http://mail.python.org/pipermail/python-dev/2012-November/122623.html
files:
 index.rst | 12 ++++++++----
 runtests.rst | 9 +++++----
 setup.rst | 4 +++-
 3 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/index.rst b/index.rst
--- a/index.rst
+++ b/index.rst
@@ -46,10 +46,14 @@
 On :ref:`Windows <windows-compiling>`, load the project file
 :file:`PCbuild\\pcbuild.sln` in Visual Studio, select :menuselection:`Debug`,
 and :menuselection:`Build --> Build Solution`.
-3. :doc:`Run the tests <runtests>` with ``./python -m test -j3`` (use
- :file:`./python.exe` on :ref:`most <python.exe>` Mac OS X systems and
- :file:`PCbuild\\python_d.exe` on Windows; replace ``test`` with
- ``test.regrtest`` for 2.7).
+3. :doc:`Run the tests <runtests>`::
+
+ ./python -m test -j3
+
+ On :ref:`most <mac-python.exe>` Mac OS X systems, replace :file:`./python`
+ with :file:`./python.exe`. On Windows, use :file:`PCbuild\\python_d.exe` or
+ check the :ref:`Windows instructions <win-python.exe>`. With Python 2.7,
+ replace ``test`` with ``test.regrtest``.
 4. Make the :doc:`patch <patch>`.
 5. Submit it to the `issue tracker`_.
 
diff --git a/runtests.rst b/runtests.rst
--- a/runtests.rst
+++ b/runtests.rst
@@ -18,10 +18,11 @@
 
 ./python -m test
 
-If you are using Python 2.7, then use the following instead as the basis
-for the commands in this section::
-
- ./python -m test.regrtest
+You may need to change this command as follows throughout this section.
+On :ref:`most <mac-python.exe>` Mac OS X systems, replace :file:`./python`
+with :file:`./python.exe`. On Windows, use :file:`PCbuild\\python_d.exe` or
+check the detailed :ref:`Windows instructions <win-python.exe>`. If using
+Python 2.7, replace ``test`` with ``test.regrtest``.
 
 If you don't have easy access to a command line, you can run the test suite from
 a Python or IDLE shell::
diff --git a/setup.rst b/setup.rst
--- a/setup.rst
+++ b/setup.rst
@@ -150,7 +150,7 @@
 Otherwise the build failed and thus should be fixed (at least with a bug being
 filed on the `issue tracker`_).
 
-.. _python.exe:
+.. _mac-python.exe:
 
 Once CPython is done building you will then have a working build
 that can be run in-place; ``./python`` on most machines (and what is used in
@@ -216,6 +216,8 @@
 Visual Studio, or choosing Start Debugging from the Debug menu, will launch
 the interpreter.
 
+.. _win-python.exe:
+
 If you want to launch the compiled interpreter from the command-line, the
 path varies according to the build. For a 32-bit build in debug mode, you
 have to invoke ``PCBuild\python_d.exe``, for a 64-bit build in debug mode,
-- 
Repository URL: http://hg.python.org/devguide
