[Zope3-checkins] SVN: zope.testing/branches/regebro-doctest-patching/src/zope/testing/doctest/__init__.py Some more comments.

[Lennart Regebro]

Log message for revision 111445:
  Some more comments.
  

Changed:
  U   zope.testing/branches/regebro-doctest-patching/src/zope/testing/doctest/__init__.py

-=-
Modified: zope.testing/branches/regebro-doctest-patching/src/zope/testing/doctest/__init__.py
===================================================================
--- zope.testing/branches/regebro-doctest-patching/src/zope/testing/doctest/__init__.py	2010-04-26 16:26:52 UTC (rev 111444)
+++ zope.testing/branches/regebro-doctest-patching/src/zope/testing/doctest/__init__.py	2010-04-26 16:28:28 UTC (rev 111445)
@@ -53,6 +53,7 @@
 
 # Patch to fix an error that makes subsequent tests fail after you have
 # returned unicode in a test.
+# Reported as #8471: http://bugs.python.org/issue8471
 import doctest
 
 _org_SpoofOut = doctest._SpoofOut
@@ -66,6 +67,7 @@
 
 
 # Patch to fix tests that has mixed line endings:
+# Reported as #8473: http://bugs.python.org/issue8473
 import os
 
 def _patched_load_testfile(filename, package, module_relative):
@@ -83,12 +85,13 @@
 doctest._load_testfile = _patched_load_testfile
 
 
-# Use a special exception for the test runner:
+# Use a special exception for the test runner.
 from zope.testing.exceptions import DocTestFailureException
 doctest.DocTestCase.failureException = DocTestFailureException
 
 
-# Patch to let the doctest have the globals of the testcase
+# Patch to let the doctest have the globals of the testcase. This is slightly
+# evil, but Zopes doctests did this, and if we change it everything breaks.
 import unittest
 
 def _patched_init(self, test, optionflags=0, setUp=None, tearDown=None,