summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorrgommers <ralf.gommers@googlemail.com>2010-10-16 22:27:05 +0800
committerrgommers <ralf.gommers@googlemail.com>2010-10-16 22:27:05 +0800
commit6cd460c0615066b33b8d36a4fc8c872b415851fc (patch)
treed9022ce882a21eb5069f3f716ddc26c2634ab084
parent658a1dc843f26cd9f1815664d1634f3f0f9d8616 (diff)
downloadnumpy-6cd460c0615066b33b8d36a4fc8c872b415851fc.tar.gz
DOC: recommend to turn on deprecation warnings for Python >= 2.7.
This was brought up on the mailing list on 10 Sep 2010.
-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