[Python-checkins] r45678 - in python/branches/release24-maint: Doc/lib/libdoctest.tex Misc/NEWS

[tim.peters]

Author: tim.peters
Date: Mon Apr 24 04:07:13 2006
New Revision: 45678

Modified:
   python/branches/release24-maint/Doc/lib/libdoctest.tex
   python/branches/release24-maint/Misc/NEWS
Log:
Merge rev 45677 from the trunk.

Bug #1337990: clarified that ``doctest`` does not support examples
requiring both expected output and an exception.


Modified: python/branches/release24-maint/Doc/lib/libdoctest.tex
==============================================================================
--- python/branches/release24-maint/Doc/lib/libdoctest.tex	(original)
+++ python/branches/release24-maint/Doc/lib/libdoctest.tex	Mon Apr 24 04:07:13 2006
@@ -407,10 +407,13 @@
 \subsubsection{What About Exceptions?\label{doctest-exceptions}}
 
 No problem, provided that the traceback is the only output produced by
-the example:  just paste in the traceback.  Since tracebacks contain
-details that are likely to change rapidly (for example, exact file paths
-and line numbers), this is one case where doctest works hard to be
-flexible in what it accepts.
+the example:  just paste in the traceback.\footnote{Examples containing
+    both expected output and an exception are not supported.  Trying
+    to guess where one ends and the other begins is too error-prone,
+    and that also makes for a confusing test.}
+Since tracebacks contain details that are likely to change rapidly (for
+example, exact file paths and line numbers), this is one case where doctest
+works hard to be flexible in what it accepts.
 
 Simple example:
 

Modified: python/branches/release24-maint/Misc/NEWS
==============================================================================
--- python/branches/release24-maint/Misc/NEWS	(original)
+++ python/branches/release24-maint/Misc/NEWS	Mon Apr 24 04:07:13 2006
@@ -54,6 +54,12 @@
 
 - Fix test_long failure on Tru64 with gcc by using -mieee gcc option.
 
+Documentation
+-------------
+
+- Bug #1337990: clarified that ``doctest`` does not support examples
+  requiring both expected output and an exception.
+
 
 What's New in Python 2.4.3?
 ===========================