diff --git a/Doc/library/test.rst b/Doc/library/test.rst index b21e177c0ad..88f03975756 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 +.. 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 45bc11822f3..3f4a921f7d9 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.