add more explanatory comments to for-else construct

raphaelquast · raphaelquast · commit 935d1b64a2c5 · 2023-07-25T15:24:14.000+02:00
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
@@ -3028,9 +3028,14 @@ def _capture_events(ax):
                 if _capture_events(ax):
                     break  # break if we hit a capturing axes
             else:
-                continue   # continue to lower zorder if we did not break
+                # If the inner loop finished without an explicit break,
+                # (e.g. no capturing axes was found) continue the
+                # outer loop to the next zorder.
+                continue
 
-            break          # break if we hit a capturing axes
+            # If the inner loop was terminated with an explicit break,
+            # terminate the outer loop as well.
+            break
 
         # avoid duplicated triggers (but keep order of list)
         pan_axes = list(dict.fromkeys(pan_axes))
