summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCharles Harris <charlesr.harris@gmail.com>2010-10-17 00:03:27 -0600
committerCharles Harris <charlesr.harris@gmail.com>2010-10-17 00:03:27 -0600
commit106d40f3e2ece8b03494fdae8e2f64528ce594e2 (patch)
tree6cd6f9498f0b3abb050f0f5289ce9613ed442f59
parentf4d9da1e86d1031e99549073681831270e450fb4 (diff)
parent6cd460c0615066b33b8d36a4fc8c872b415851fc (diff)
downloadnumpy-106d40f3e2ece8b03494fdae8e2f64528ce594e2.tar.gz
Merge branch 'deprecation-docs' of http://github.com/rgommers/numpy into rgommers-deprecation-docs
-rw-r--r--README.txt6
-rw-r--r--doc/TESTS.txt7
2 files changed, 13 insertions, 0 deletions
diff --git a/README.txt b/README.txt
index f835004d2..7ec97e100 100644
--- a/README.txt
+++ b/README.txt
@@ -16,6 +16,12 @@ After installation, tests can be run with:
python -c 'import numpy; numpy.test()'
+When installing a new version of numpy for the first time or before upgrading
+to a newer version, it is recommended to turn on deprecation warnings when
+running the tests:
+
+python -Wd -c 'import numpy; numpy.test()'
+
The most current development version is always available from our
git repository:
diff --git a/doc/TESTS.txt b/doc/TESTS.txt
index c0b866054..936f00a1d 100644
--- a/doc/TESTS.txt
+++ b/doc/TESTS.txt
@@ -41,6 +41,13 @@ 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
+ >>> wwarnings.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