summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorRalf Gommers <ralf.gommers@googlemail.com>2012-03-04 14:09:48 +0100
committerMark Wiebe <mwwiebe@gmail.com>2012-03-04 12:59:21 -0800
commit7961e1f56ec9754cafcb9a67445b01d47d1b1676 (patch)
treeab2bf9cae04603618061cc7a8fa6a924eaca7d8e /doc
parente692a7579b89bf43e8456f418e6b625a4e4a4233 (diff)
downloadnumpy-7961e1f56ec9754cafcb9a67445b01d47d1b1676.tar.gz
TST: add "raise on warning" behavior to NoseTester constructor.
Also document that behavior has to be switched for a release, and remove comments on turning on deprecation warnings that don't apply anymore.
Diffstat (limited to 'doc')
-rw-r--r--doc/HOWTO_RELEASE.rst.txt11
-rw-r--r--doc/TESTS.rst.txt7
2 files changed, 11 insertions, 7 deletions
diff --git a/doc/HOWTO_RELEASE.rst.txt b/doc/HOWTO_RELEASE.rst.txt
index c31201801..d0b16a9c2 100644
--- a/doc/HOWTO_RELEASE.rst.txt
+++ b/doc/HOWTO_RELEASE.rst.txt
@@ -187,6 +187,17 @@ Check the buildbot
------------------
The buildbot is located at `<http://buildbot.scipy.org/>`_.
+Handle test warnings
+--------------------
+The default behavior of the test suite in the master branch is to report errors
+for DeprecationWarnings and RuntimeWarnings that are issued. For a released
+version this is not desired. Therefore any known warnings should be solved or
+explicitly silenced before making the release branch, then when the branch is
+made, the default behavior should be switched to not raise errors. This is
+done in the constructor of the NoseTester class in numpy/testing/nosetester.py,
+by replacing ``raise_warnings=(DeprecationWarning, RuntimeWarning)`` with
+``raise_warnings=()``.
+
Make sure current trunk builds a package correctly
--------------------------------------------------
::
diff --git a/doc/TESTS.rst.txt b/doc/TESTS.rst.txt
index a192a32b7..a6387d7b2 100644
--- a/doc/TESTS.rst.txt
+++ b/doc/TESTS.rst.txt
@@ -41,13 +41,6 @@ follows::
>>> import numpy
>>> numpy.test()
-Note that for Python >= 2.7 deprecation warnings are silent by default. They
-can be turned on (recommended after installation and before upgrading) by
-starting the interpreter with the -Wd switch, or by::
-
- >>> import warnings
- >>> warnings.simplefilter('always', DeprecationWarning)
-
The test method may take two or more arguments; the first is a string
label specifying what should be tested and the second is an integer
giving the level of output verbosity. See the docstring for numpy.test