Better document super call

timhoffm · timhoffm · commit ccf199496c40 · 2025-09-11T11:10:20.000+02:00
diff --git a/src/_macosx.m b/src/_macosx.m
@@ -572,7 +572,7 @@ bool mpl_check_modifier(bool present, PyObject* list, char const* name)
     },
 };
 
-static PyTypeObject FigureManagerType;
+static PyTypeObject FigureManagerType;  // forward declaration, needed in destroy()
 
 typedef struct {
     PyObject_HEAD
@@ -689,7 +689,8 @@ bool mpl_check_modifier(bool present, PyObject* list, char const* name)
     [self->window close];
     self->window = NULL;
 
-    // call super().destroy()
+    // call super(self, FigureManager).destroy() - it seems we need the
+    // explicit arguments, and just super() doesn't work in the C API.
     PyObject *super_obj = PyObject_CallFunctionObjArgs(
         (PyObject *)&PySuper_Type,
         (PyObject *)&FigureManagerType,
