[3.11] IDLE: Add util and stub example comments (GH-113222) (#113224)

(cherry picked from commit cde1335485b7bffb12c378d230ae48ad77d76ab1)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

diff --git a/Lib/idlelib/idle_test/example_stub.pyi b/Lib/idlelib/idle_test/example_stub.pyi
index a9811a78d10a6e7121986fc82c5f61282d0dea9d..17b58010a9d8de8f6737998d6277dc51c823841e 100644 (file)
--- a/Lib/idlelib/idle_test/example_stub.pyi
+++ b/Lib/idlelib/idle_test/example_stub.pyi
@@ -1,2 +1,4 @@
+" Example to test recognition of .pyi file as Python source code.
+
 class Example:
     def method(self, argument1: str, argument2: list[int]) -> None: ...

diff --git a/Lib/idlelib/util.py b/Lib/idlelib/util.py
index 5ac69a7b94cb56d33dce45f013d8765c073e7d33..a7ae74b0579004a180a16f4817448034f71c36bd 100644 (file)
--- a/Lib/idlelib/util.py
+++ b/Lib/idlelib/util.py
@@ -13,9 +13,9 @@ TODO:
     * warning stuff (pyshell, run).
 """
 
-# .pyw is for Windows; .pyi is for stub files.
-py_extensions = ('.py', '.pyw', '.pyi')  # Order needed for open/save dialogs.
-
+# .pyw is for Windows; .pyi is for typing stub files.
+# The extension order is needed for iomenu open/save dialogs.
+py_extensions = ('.py', '.pyw', '.pyi')
 
 if __name__ == '__main__':
     from unittest import main