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

miss-islington · terryjreedy · web-flow · commit f7cacc43f56a · 2023-12-17T01:18:21.000Z
(cherry picked from commit cde1335) 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
@@ -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
@@ -13,9 +13,9 @@
     * 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
