Explain members of Symbol type

gvanrossum · Feb 27, 2024 · 13a60a8 · 13a60a8
1 parent ef31003
commit 13a60a8
Showing 1 changed file with 3 additions and 4 deletions.
diff --git a/Include/internal/pycore_optimizer.h b/Include/internal/pycore_optimizer.h
@@ -30,10 +30,9 @@ extern PyTypeObject _PyUOpOptimizer_Type;
 /* See explanation in optimizer_symbols.c */
 
 struct _Py_UopsSymbol {
-    int flags;
-    PyTypeObject *typ;
-    // constant propagated value (might be NULL)
-    PyObject *const_val;
+    int flags;  // 0 bits: Top; 2 or more bits: Bottom
+    PyTypeObject *typ;  // Borrowed reference
+    PyObject *const_val;  // Owned reference (!)
 };
 
 // Holds locals, stack, locals, stack ... co_consts (in that order)