[Python-checkins] (2.7): #11298: Improve the unittest discovery explanation.

[ezio.melotti]

http://hg.python.org/cpython/rev/88b5a93b1725
changeset:   68331:88b5a93b1725
branch:      2.7
parent:      68328:c0172f8f9bac
user:        Ezio Melotti <ezio.melotti at gmail.com>
date:        Tue Mar 08 17:08:25 2011 +0200
summary:
  #11298: Improve the unittest discovery explanation.

files:
  Doc/library/unittest.rst

diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
--- a/Doc/library/unittest.rst
+++ b/Doc/library/unittest.rst
@@ -257,9 +257,11 @@
 
 .. versionadded:: 2.7
 
-Unittest supports simple test discovery. For a project's tests to be
-compatible with test discovery they must all be importable from the top level
-directory of the project (in other words, they must all be in Python packages).
+Unittest supports simple test discovery. In order to be compatible with test
+discovery, all of the test files must be :ref:`modules <tut-modules>` or
+:ref:`packages <tut-packages>` importable from the top-level directory of
+the project (this means that their filenames must be valid
+:ref:`identifiers <identifiers>`).
 
 Test discovery is implemented in :meth:`TestLoader.discover`, but can also be
 used from the command line. The basic command-line usage is::

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