Blocked revisions 83072 via svnmerge
........
r83072 | brett.cannon | 2010-07-23 12:31:31 +0100 (Fri, 23 Jul 2010) | 5 lines
Document the fact that the 'test' package is meant only for use by Python
itself and not by others.
Closes issue 9255.
........
diff --git a/Doc/library/test.rst b/Doc/library/test.rst
index 974f71f..0b16109 100644
--- a/Doc/library/test.rst
+++ b/Doc/library/test.rst
@@ -5,6 +5,13 @@
:synopsis: Regression tests package containing the testing suite for Python.
.. sectionauthor:: Brett Cannon <brett@python.org>
+.. note::
+ The :mod:`test` package is meant for internal use by Python only. It is
+ documented for the benefit of the core developers of Python. Any use of
+ this package outside of Python's standard library is discouraged as code
+ mentioned here can change or be removed without notice between releases of
+ Python.
+
The :mod:`test` package contains all regression tests for Python as well as the
modules :mod:`test.support` and :mod:`test.regrtest`.
diff --git a/Misc/NEWS b/Misc/NEWS
index 7f3f0e1..5c25c6c 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -369,6 +369,9 @@
Documentation
-------------
+- Issue 9255: Document that the 'test' package is meant for interal Python use
+ only.
+
- Issue #7829: Document in dis that bytecode is an implementation detail.