summaryrefslogtreecommitdiffstats
path: root/Misc
diff options
context:
space:
mode:
authorRaymond Hettinger <python@rcn.com>2003-07-16 19:25:22 (GMT)
committerRaymond Hettinger <python@rcn.com>2003-07-16 19:25:22 (GMT)
commit71adf7e9d8fb2aca563eeca806ea127409c82bb6 (patch)
tree6920d22bafb25a9b5bf685f05dcbc7cfbb02adcb /Misc
parent853276e16d6dfc214fcb88b53fe07fba21b58120 (diff)
downloadcpython-71adf7e9d8fb2aca563eeca806ea127409c82bb6.zip
cpython-71adf7e9d8fb2aca563eeca806ea127409c82bb6.tar.gz
cpython-71adf7e9d8fb2aca563eeca806ea127409c82bb6.tar.bz2
Doctest now examines all docstrings by default. Previously, it would
skip over functions with private names (as indicated by the underscore naming convention). The old default created too much of a risk that user tests were being skipped inadvertently. Note, this change could break code in the unlikely case that someone had intentionally put failing tests in the docstrings of private functions. The breakage is easily fixable by specifying the old behavior when calling testmod() or Tester(). The more likely case is that the silent failure was unintended and that the user needed to be informed so the test could be fixed.
Diffstat (limited to 'Misc')
-rw-r--r--Misc/NEWS9
1 files changed, 9 insertions, 0 deletions
diff --git a/Misc/NEWS b/Misc/NEWS
index 9b9b567..ddf76ff 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -38,6 +38,15 @@ Extension modules
Library
-------
+- doctest now examines all docstrings by default. Previously, it would
+ skip over functions with private names (as indicated by the underscore
+ naming convention). The old default created too much of a risk that
+ user tests were being skipped inadvertently. Note, this change could
+ break code in the unlikely case that someone had intentionally put
+ failing tests in the docstrings of private functions. The breakage
+ is easily fixable by specifying the old behavior when calling testmod()
+ or Tester().
+
- Closing a dumbdbm database more than once is now harmless (it used to
raise a nuisance exception on the second close).