Provide module docstrings for the two main test drivers in importlib that

explain what they are for and how to use command-line arguments to tweak
semantics.

2 files changed, 11 insertions, 2 deletions

diff --git a/Lib/importlib/test/__main__.py b/Lib/importlib/test/__main__.py
index 89e1391..b97e382 100644
--- a/Lib/importlib/test/__main__.py
+++ b/Lib/importlib/test/__main__.py
@@ -1,3 +1,9 @@
+"""Run importlib's test suite.
+
+Specifying the ``--builtin`` flag will run tests, where applicable, with
+builtins.__import__ instead of importlib.__import__.
+
+"""
 import importlib
 from importlib.test.import_ import util
 import os.path
diff --git a/Lib/importlib/test/regrtest.py b/Lib/importlib/test/regrtest.py
index 7010165..17e7f4e 100644
--- a/Lib/importlib/test/regrtest.py
+++ b/Lib/importlib/test/regrtest.py
@@ -1,8 +1,11 @@
 """Run Python's standard test suite using importlib.__import__.
 
+Tests known to fail because of assumptions that importlib (properly)
+invalidates are automatically skipped if the entire test suite is run.
+Otherwise all command-line options valid for test.regrtest are also valid for
+this script.
+
 XXX FAILING
-    test___all__  # tuple being given for fromlist (looks like interpreter is
-                    doing it)
     test_builtin  # Wanting a TypeError for an integer name
     test_import  # execution bit, exception name differing, file name differing
                     between code and module (?)