requested comment changes

Author: tom-pytel

Python/assemble.c

@@ -534,6 +534,9 @@ compute_localsplus_info(_PyCompile_CodeUnitMetadata *umd, int nlocalsplus,
         assert(offset >= 0);
         offset += nlocals - numdropped;
         assert(offset < nlocalsplus);
+        /* XXX If the assertion below fails it is most likely because a freevar
+           was added to u_freevars with the wrong index due to not taking into
+           account cellvars already present, see gh-128632. */
         assert(offset > cellvar_offset);
         _Py_set_localsplus_info(offset, k, CO_FAST_FREE, names, kinds);
     }

Python/codegen.c

@@ -3065,9 +3065,6 @@ codegen_addop_yield(compiler *c, location loc) {
     return SUCCESS;
 }
 
-/* XXX: Currently if this is used to insert a new name into u_freevars when
-   there are already entries in u_cellvars then the wrong index will be put
-   into u_freevars causing a hard error downstream. */
 static int
 codegen_load_classdict_freevar(compiler *c, location loc)
 {

Python/compile.c

@@ -970,9 +970,6 @@ _PyCompile_ResolveNameop(compiler *c, PyObject *mangled, int scope,
         break;
     }
     if (*optype != COMPILE_OP_FAST) {
-        /* XXX: Currently if this is used to insert a new name into u_freevars when
-           there are already entries in u_cellvars then the wrong index will be put
-           into u_freevars causing a hard error downstream. */
         *arg = _PyCompile_DictAddObj(dict, mangled);
         RETURN_IF_ERROR(*arg);
     }