diff options
author | rgommers <ralf.gommers@googlemail.com> | 2010-10-16 22:27:05 +0800 |
---|---|---|
committer | rgommers <ralf.gommers@googlemail.com> | 2010-10-16 22:27:05 +0800 |
commit | 6cd460c0615066b33b8d36a4fc8c872b415851fc (patch) | |
tree | d9022ce882a21eb5069f3f716ddc26c2634ab084 | |
parent | 658a1dc843f26cd9f1815664d1634f3f0f9d8616 (diff) | |
download | numpy-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.txt | 6 | ||||
-rw-r--r-- | doc/TESTS.txt | 7 |
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 |