FIX: Add warning and docs for manual label removal in ContourSet

buddy0452004 · buddy0452004 · commit d35b9cd9fcb8 · 2026-04-03T11:51:04.000+05:30
diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
@@ -143,6 +143,10 @@ def clabel(self, levels=None, *,
         -------
         labels
             A list of `.Text` instances for the labels.
+
+            Note: The returned .Text instances should not be individually
+            removed or have their geometry modified. To remove all labels,
+            remove the entire .ContourSet and recreate it.
         """
 
         if self.filled:
@@ -518,7 +522,12 @@ def remove(self):
             try:
                 text.remove()
             except ValueError:
-                pass
+                import warnings
+                warnings.warn(
+                    "Some labels were manually removed before the ContourSet. "
+                    "To remove labels cleanly, remove the entire ContourSet "
+                    "and recreate it.",
+                    UserWarning, stacklevel=2)
         self.labelTexts.clear()
 
 
