Update testing documentation

HolgerPeters · HolgerPeters · commit 4356063f6f29 · 2015-03-18T08:05:44.000+01:00
diff --git a/doc/devel/testing.rst b/doc/devel/testing.rst
@@ -41,14 +41,20 @@ the setup script's ``test`` command::
 
    python setup.py test
 
-in the root directory of the distribution.
-The script can take any of the usual `nosetest arguments`_, such as
-
-===================  ===========
-``--nose-verbose``   increase verbosity
-``-d``               detailed error messages
-``--with-coverage``  enable collecting coverage information
-===================  ===========
+in the root directory of the distribution. The script takes a set of
+commands, such as:
+
+========================  ===========
+``--pep8-only``           pep8 checks
+``--omit-pep8``           Do not perform pep8 checks
+``--nocapture``           do not capture stdout (nosetests)
+``--nose-verbose``        be verbose (nosetests)
+``--processes``           number of processes (nosetests)
+``--process-timeout``     process timeout (nosetests)
+``--with-coverage``       with coverage
+``--detailed-error-msg``  detailed error message (nosetest)
+``--tests``               comma separated selection of tests (nosetest)
+========================  ===========
 
 Additionally it is possible to run only coding standard test or disable them:
 
@@ -61,27 +67,34 @@ To run a single test from the command line, you can provide a
 dot-separated path to the module followed by the function separated by
 a colon, e.g., (this is assuming the test is installed)::
 
-  python tests.py matplotlib.tests.test_simplification:test_clipping
-
-If you want to run the full test suite, but want to save wall time try running the
-tests in parallel::
+  python setup.py tests --tests=matplotlib.tests.test_simplification:test_clipping
 
-  python ../matplotlib/tests.py -sv --processes=5 --process-timeout=300
+If you want to run the full test suite, but want to save wall time try
+running the tests in parallel::
 
+  python setup.py test --nocapture --nose-verbose --processes=5 --process-timeout=300
 
 
 An alternative implementation that does not look at command line
-arguments works from within Python::
+arguments works from within Python is to run the tests from the
+matplotlibs library function :func:`matplotlib.test`::
 
   import matplotlib
   matplotlib.test()
 
+.. hint::
+
+   You might need to install nose for this::
+
+      pip install nose
+
+
 .. _`nosetest arguments`: http://nose.readthedocs.org/en/latest/usage.html
 
 
-Running tests by any means other than `matplotlib.test()`
-does not load the nose "knownfailureif" (Known failing tests) plugin,
-causing known-failing tests to fail for real.
+Running tests by any means other than `matplotlib.test()` does not
+load the nose "knownfailureif" (Known failing tests) plugin, causing
+known-failing tests to fail for real.
 
 Writing a simple test
 ---------------------
