summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2011-07-30 07:00:48 (GMT)
committerGeorg Brandl <georg@python.org>2011-07-30 07:00:48 (GMT)
commiteea6cda91a074fedd2d14eb1d8654d65fc616c09 (patch)
treee828a4684c5ae459a2e4360acdf5c3b175521ccc /Doc/library
parent7bd081c1179e0dd7f7f325ff07a2b50f1f760db0 (diff)
downloadcpython-eea6cda91a074fedd2d14eb1d8654d65fc616c09.zip
cpython-eea6cda91a074fedd2d14eb1d8654d65fc616c09.tar.gz
cpython-eea6cda91a074fedd2d14eb1d8654d65fc616c09.tar.bz2
Change test.support docs to be more specific about the nature of this module.
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/test.rst19
1 files changed, 12 insertions, 7 deletions
diff --git a/Doc/library/test.rst b/Doc/library/test.rst
index 9d02b0a..c27ee08 100644
--- a/Doc/library/test.rst
+++ b/Doc/library/test.rst
@@ -187,19 +187,24 @@ executing :program:`rt.bat` from your :file:`PCBuild` directory will run all
regression tests.
-:mod:`test.support` --- Utility functions for tests
-===================================================
+:mod:`test.support` --- Utilities for the Python test suite
+===========================================================
.. module:: test.support
- :synopsis: Support for Python regression tests.
+ :synopsis: Support for Python's regression test suite.
The :mod:`test.support` module provides support for Python's regression
-tests.
+test suite.
-This module defines the following exceptions:
+.. note::
+ :mod:`test.support` is not a public module. It is documented here to help
+ Python developers write tests. The API of this module is subject to change
+ without backwards compatibility concerns between releases.
+This module defines the following exceptions:
+
.. exception:: TestFailed
Exception to be raised when a test fails. This is deprecated in favor of
@@ -213,8 +218,8 @@ This module defines the following exceptions:
network connection) is not available. Raised by the :func:`requires`
function.
-The :mod:`test.support` module defines the following constants:
+The :mod:`test.support` module defines the following constants:
.. data:: verbose
@@ -233,8 +238,8 @@ The :mod:`test.support` module defines the following constants:
Set to a name that is safe to use as the name of a temporary file. Any
temporary file that is created should be closed and unlinked (removed).
-The :mod:`test.support` module defines the following functions:
+The :mod:`test.support` module defines the following functions:
.. function:: forget(module_name)