Update backend dependency docs.

anntzer · anntzer · commit 656fe2c46067 · 2020-02-10T14:15:11.000+01:00
- Add PySide2 as an option for Qt5Agg.
- Move links in unrendered docs out of the main text, which makes it
  more readable.
- Switch some links to readthedocs, which should be more useful than
  PyPI links.
- Remove mention of need of cairo for gtk in usage.py, given that the
  exact same info (including the need of cairo for gtk3agg) is stated in
  the backend table just above.
diff --git a/INSTALL.rst b/INSTALL.rst
@@ -120,20 +120,25 @@ Optionally, you can also install a number of packages to enable better user
 interface toolkits. See :ref:`what-is-a-backend` for more details on the
 optional Matplotlib backends and the capabilities they provide.
 
-* `Tk <https://docs.python.org/3/library/tk.html>`_ (>= 8.3, != 8.6.0 or
-  8.6.1): for the Tk-based backends;
-* `PyQt4 <https://pypi.org/project/PyQt4>`_ (>= 4.6) or
-  `PySide <https://pypi.org/project/PySide>`_ (>= 1.0.3) [#]_: for the
-  Qt4-based backends;
-* `PyQt5 <https://pypi.org/project/PyQt5>`_: for the Qt5-based backends;
-* `PyGObject <https://pypi.org/project/PyGObject/>`_: for the GTK3-based
-  backends [#]_;
-* `wxPython <https://www.wxpython.org/>`_ (>= 4) [#]_: for the wx-based
+* Tk_ (>= 8.3, != 8.6.0 or 8.6.1): for the Tk-based backends;
+* PyQt4_ (>= 4.6) or PySide_ (>= 1.0.3) [#]_: for the Qt4-based backends;
+* PyQt5_ or PySide2_: for the Qt5-based backends;
+* PyGObject_: for the GTK3-based backends [#]_;
+* wxPython_ (>= 4) [#]_: for the wx-based backends;
+* pycairo_ (>= 1.11.0) or cairocffi_ (>= 0.8): for the GTK3 and/or cairo-based
   backends;
-* `cairocffi <https://cairocffi.readthedocs.io/en/latest/>`_ (>= 0.8) or
-  `pycairo <https://pypi.org/project/pycairo>`_: for the cairo-based
-  backends;
-* `Tornado <https://pypi.org/project/tornado>`_: for the WebAgg backend;
+* Tornado_: for the WebAgg backend;
+
+.. _Tk: https://docs.python.org/3/library/tk.html
+.. _PyQt4: https://pypi.org/project/PyQt4
+.. _PySide: https://pypi.org/project/PySide
+.. _PyQt5: https://pypi.org/project/PyQt5
+.. _PySide2: https://pypi.org/project/PySide2
+.. _PyGObject: https://pygobject.readthedocs.io/en/latest/
+.. _wxPython: https://www.wxpython.org/
+.. _pycairo: https://pycairo.readthedocs.io/en/latest/
+.. _cairocffi: https://cairocffi.readthedocs.io/en/latest/
+.. _Tornado: https://pypi.org/project/tornado
 
 .. [#] PySide cannot be pip-installed on Linux (but can be conda-installed).
 .. [#] If using pip (and not conda), PyGObject must be built from source; see
diff --git a/tutorials/introductory/usage.py b/tutorials/introductory/usage.py
@@ -475,12 +475,6 @@ def my_plotter(ax, data1, data2, param_dict):
 # See `jupyter-matplotlib <https://github.com/matplotlib/jupyter-matplotlib>`__
 # for more details.
 #
-# GTK and Cairo
-# ^^^^^^^^^^^^^
-#
-# ``GTK3`` backends (*both* ``GTK3Agg`` and ``GTK3Cairo``) depend on Cairo
-# (pycairo>=1.11.0 or cairocffi).
-#
 # .. _QT_API-usage:
 #
 # How do I select PyQt4 or PySide?

Original file line number	Diff line number	Diff line change
`@@ -475,12 +475,6 @@ def my_plotter(ax, data1, data2, param_dict):`
`475`	`475`	# See `jupyter-matplotlib <https://github.com/matplotlib/jupyter-matplotlib>`__
`476`	`476`	`# for more details.`
`477`	`477`	`#`
`478`		`-# GTK and Cairo`
`479`		`-# ^^^^^^^^^^^^^`
`480`		`-#`
`481`		-# ``GTK3`` backends (both ``GTK3Agg`` and ``GTK3Cairo``) depend on Cairo
`482`		`-# (pycairo>=1.11.0 or cairocffi).`
`483`		`-#`
`484`	`478`	`# .. _QT_API-usage:`
`485`	`479`	`#`
`486`	`480`	`# How do I select PyQt4 or PySide?`