Merge pull request #4291 from azjps/nbagg_middle20150328

jenshnielsen · jenshnielsen · commit f532615e2e8b · 2015-04-05T11:45:51.000+01:00
Add note about nbagg middle click button
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
@@ -15,7 +15,7 @@
 
 :class:`Event`
     The base class for all of the matplotlib event
-    handling.  Derived classes suh as :class:`KeyEvent` and
+    handling.  Derived classes such as :class:`KeyEvent` and
     :class:`MouseEvent` store the meta data like keys and buttons
     pressed, x and y locations in pixel and
     :class:`~matplotlib.axes.Axes` coordinates.
@@ -1499,7 +1499,9 @@ class MouseEvent(LocationEvent):
 
     *button*
         button pressed None, 1, 2, 3, 'up', 'down' (up and down are used
-        for scroll events)
+        for scroll events).  Note that in the nbagg backend, both the
+        middle and right clicks return 3 since right clicking will bring
+        up the context menu in some browsers.
 
     *key*
         the key depressed when the mouse event triggered (see
diff --git a/lib/matplotlib/backends/backend_webagg_core.py b/lib/matplotlib/backends/backend_webagg_core.py
@@ -296,7 +296,8 @@ def handle_event(self, event):
             # The right mouse button pops up a context menu, which
             # doesn't work very well, so use the middle mouse button
             # instead.  It doesn't seem that it's possible to disable
-            # the context menu in recent versions of Chrome.
+            # the context menu in recent versions of Chrome.  If this
+            # is resolved, please also adjust the docstring in MouseEvent.
             if button == 2:
                 button = 3
 
