Add docstring and additional test revealing nuances of the implementation as found...

diff --git a/Lib/distutils/tests/test_filelist.py b/Lib/distutils/tests/test_filelist.py
index 45ff56537344f9c43b5130a9faf3da233f9b923b..571acdbc08262e02e26244edc9314bc66d2c3bfe 100644 (file)
--- a/Lib/distutils/tests/test_filelist.py
+++ b/Lib/distutils/tests/test_filelist.py
@@ -302,6 +302,11 @@ class FindAllTestCase(unittest.TestCase):
             self.assertEqual(filelist.findall(), [])
 
     def test_basic_discovery(self):
+        """
+        When findall is called with no parameters or with
+        '.' as the parameter, the dot should be omitted from
+        the results.
+        """
         with test.support.temp_cwd():
             os.mkdir('foo')
             file1 = os.path.join('foo', 'file1.txt')
@@ -312,6 +317,17 @@ class FindAllTestCase(unittest.TestCase):
             expected = [file1, file2]
             self.assertEqual(filelist.findall(), expected)
 
+    def test_non_local_discovery(self):
+        """
+        When findall is called with another path, the full
+        path name should be returned.
+        """
+        with test.support.temp_dir() as temp_dir:
+            file1 = os.path.join(temp_dir, 'file1.txt')
+            test.support.create_empty_file(file1)
+            expected = [file1]
+            self.assertEqual(filelist.findall(temp_dir), expected)
+
 
 if __name__ == "__main__":
     unittest.main()