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.

diff --git a/Lib/importlib/test/__main__.py b/Lib/importlib/test/__main__.py
index 89e139191aff60258767d334c9a17e22b6b75a3b..b97e3821959175d1be8effd3eca8b2a5cd26df03 100644 (file)
--- 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 7010165c200e769f7cfa5a4db36dde0a42da957d..17e7f4ef79df06d4756c7aede1300be2bf6f6cd2 100644 (file)
--- 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 (?)