Isolate old-style singleton api tests.

1 files changed, 4 insertions, 2 deletions

diff --git a/coverage/__init__.py b/coverage/__init__.py
index 777d451b..a81f61ac 100644
--- a/coverage/__init__.py
+++ b/coverage/__init__.py
@@ -17,8 +17,10 @@ from coverage.misc import CoverageException
 
 # Module-level functions.  The original API to this module was based on
 # functions defined directly in the module, with a singleton of the coverage()
-# class.  That design hampered programmability.  Here we define the top-level
-# functions to create the singleton when they are first called.
+# class.  That design hampered programmability, so the current api uses
+# explicitly-created coverage objects.  But for backward compatibility, here we
+# define the top-level functions to create the singleton when they are first
+# called.
 
 # Singleton object for use with module-level functions.  The singleton is
 # created as needed when one of the module-level functions is called.