From: Brett Cannon <bcannon@gmail.com>
Date: Fri, 23 Jul 2010 12:07:27 +0000 (+0000)
Subject: Merged revisions 83072 via svnmerge from
X-Git-Tag: v2.7.1rc1~571
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9ae2cb740ae692bbda5a1728b5843ae84c7e3eb5;p=python

Merged revisions 83072 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  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 b21e177c0a..88f0397575 100644
--- a/Doc/library/test.rst
+++ b/Doc/library/test.rst
@@ -6,6 +6,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.test_support` and :mod:`test.regrtest`.
diff --git a/Misc/NEWS b/Misc/NEWS
index 45bc11822f..3f4a921f7d 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -64,6 +64,8 @@ Tests
 Documentation
 -------------
 
+- Issue 9255: Document that the 'test' package is for internal Python use only.
+
 - Issue 7829: Document in dis that bytecode is an implementation detail.