update comments

python · JelleZijlstra · Jun 20, 2024 · Jun 6, 2024 · Jun 6, 2024 · Jun 6, 2024
commit 1352d0856ba7d513d341a29b30675312d98f145c
diff --git a/Lib/symtable.py b/Lib/symtable.py
@@ -231,13 +231,15 @@ def is_local_symbol(ident):
                 if is_local_symbol(st.name):
                     if st.type == _symtable.TYPE_TYPE_PARAM:
                         # Current 'st' is an annotation scope with one or
-                        # more children (we expect only one, but ,
-                        # so we need to find the corresponding inner function,
-                        # class or type alias.
+                        # more children (we expect only one, but we might
+                        # have more in the future). In particular, we need
+                        # to find the corresponding inner function, class or
+                        # type alias.
                         st = next((c for c in st.children if c.name == st.name), None)
                         # if 'st' is None, then the annotation scopes are broken
                         assert st is not None, 'annotation scopes are broken'
 
+                    # only select function-like symbols
                     if st.type == _symtable.TYPE_FUNCTION:
                         d[st.name] = 1
             self.__methods = tuple(d)