[Python-checkins] devguide: Add section on unexpected skips when running the tests

[nick.coghlan]

http://hg.python.org/devguide/rev/9fee8e6c2619
changeset:   522:9fee8e6c2619
user:        Nick Coghlan <ncoghlan at gmail.com>
date:        Sun Jun 17 19:14:39 2012 +1000
summary:
  Add section on unexpected skips when running the tests

files:
  runtests.rst |  18 ++++++++++++++++++
  1 files changed, 18 insertions(+), 0 deletions(-)


diff --git a/runtests.rst b/runtests.rst
--- a/runtests.rst
+++ b/runtests.rst
@@ -71,6 +71,24 @@
 above.
 
 
+Unexpected Skips
+----------------
+
+Sometimes when running the test suite, you will see "unexpected skips"
+reported. These represent cases where an entire test module has been
+skipped, but the test suite normally expects the tests in that module to
+be executed on that platform.
+
+Often, the cause is that an optional module hasn't been built due to missing
+build dependencies. In these cases, the missing module reported when the test
+is skipped should match one of the modules reported as failing to build when
+:ref:`compiling`.
+
+In other cases, the skip message should provide enough detail to help figure
+out and resolve the cause of the problem (for example, the default security
+settings on some platforms will disallow some tests)
+
+
 Writing
 -------
 

-- 
Repository URL: http://hg.python.org/devguide