[Python-checkins] devguide: Silence warnings as an advanced task.

[brett.cannon]

brett.cannon pushed 06153bf9044e to devguide:

http://hg.python.org/devguide/rev/06153bf9044e
changeset:   59:06153bf9044e
tag:         tip
user:        Brett Cannon <brett at python.org>
date:        Sat Jan 08 15:24:37 2011 -0800
summary:
  Silence warnings as an advanced task.

files:
  silencewarnings.rst

diff --git a/silencewarnings.rst b/silencewarnings.rst
new file mode 100644
--- /dev/null
+++ b/silencewarnings.rst
@@ -0,0 +1,19 @@
+.. _silencewarnings:
+
+Silence Warnings From the Test Suite
+====================================
+
+When running Python's test suite, no warnings should result::
+
+    ./python -m -W error test -uall
+
+Unfortunately new warnings are added to Python on occasion which take some time
+to eliminate (e.g., ``ResourceWarning``). Typically the easy warnings are dealt
+with quickly, but the more difficult ones that require some thought and work do
+not get fixed immediately.
+
+If you decide to tackle a warning you have found, open an issue on the `issue
+tracker`_ (if one has not already been opened) and say you are going to try and
+tackle the issue, and then proceed to fix the issue.
+
+.. _issue tracker: http://bugs.python.org

--
Repository URL: http://hg.python.org/devguide