Replace :ref:sphx_glr_... by :doc:/....

The latter form is shorter, not specific to sphinx-gallery, maps more
cleanly to the actual path (no confusion between underscores and
slashes), and links to the example page itself rather than an anchor
just below it.

Done by sed + manual checking.

Author: anntzer

doc/api/api_changes.rst

@@ -30,7 +30,7 @@ New dependency
 
 `kiwisolver <https://github.com/nucleic/kiwi>`__ is now a required
 dependency to support the new constrained_layout,  see
-:ref:`sphx_glr_tutorials_intermediate_constrainedlayout_guide.py` for
+:doc:`/tutorials/intermediate/constrainedlayout_guide` for
 more details.
 
 
@@ -1603,7 +1603,7 @@ original location:
 * The legend handler interface has changed from a callable, to any object
   which implements the ``legend_artists`` method (a deprecation phase will
   see this interface be maintained for v1.4). See
-  :ref:`sphx_glr_tutorials_intermediate_legend_guide.py` for further details. Further legend changes
+  :doc:`/tutorials/intermediate/legend_guide` for further details. Further legend changes
   include:
 
    * :func:`matplotlib.axes.Axes._get_legend_handles` now returns a generator

doc/api/pyplot_summary.rst

@@ -8,7 +8,7 @@ The Pyplot API
 The :mod:`matplotlib.pyplot` module contains functions that allow you to generate
 many kinds of plots quickly. For examples that showcase the use
 of the :mod:`matplotlib.pyplot` module, see the
-:ref:`sphx_glr_tutorials_introductory_pyplot.py`
+:doc:`/tutorials/introductory/pyplot`
 or the :ref:`pyplots_examples`. We also recommend that you look into
 the object-oriented approach to plotting, described below.
 
@@ -38,6 +38,6 @@ There are many colormaps you can use to map data onto color values.
 Below we list several ways in which color can be utilized in Matplotlib.
 
 For a more in-depth look at colormaps, see the
-:ref:`sphx_glr_tutorials_colors_colormaps.py` tutorial.
+:doc:`/tutorials/colors/colormaps` tutorial.
 
 .. autofunction:: colormaps

doc/api/toolkits/index.rst

@@ -21,7 +21,7 @@ mplot3d
 plotting (scatter, surf, line, mesh) tools.  Not the fastest or most feature
 complete 3D library out there, but it ships with Matplotlib and thus may be a
 lighter weight solution for some use cases. Check out the
-:ref:`mplot3d tutorial <sphx_glr_tutorials_toolkits_mplot3d.py>` for more
+:doc:`mplot3d tutorial </tutorials/toolkits/mplot3d>` for more
 information.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_contourf3d_2_001.png

doc/api/toolkits/mplot3d/index.rst

@@ -11,7 +11,7 @@ The mplot3d toolkit adds simple 3D plotting capabilities to matplotlib by
 supplying an axes object that can create a 2D projection of a 3D scene.
 The resulting graph will have the same look and feel as regular 2D plots.
 
-See the :ref:`mplot3d tutorial <sphx_glr_tutorials_toolkits_mplot3d.py>` for
+See the :doc:`mplot3d tutorial </tutorials/toolkits/mplot3d>` for
 more information on how to use this toolkit.
 
 .. image:: /_static/demo_mplot3d.png

doc/devel/contributing.rst

@@ -479,7 +479,7 @@ Developing a new backend
 ------------------------
 
 If you are working on a custom backend, the *backend* setting in
-:file:`matplotlibrc` (:ref:`sphx_glr_tutorials_introductory_customizing.py`) supports an
+:file:`matplotlibrc` (:doc:`/tutorials/introductory/customizing`) supports an
 external backend via the ``module`` directive.  If
 :file:`my_backend.py` is a Matplotlib backend in your
 :envvar:`PYTHONPATH`, you can set it on one of several ways

doc/faq/howto_faq.rst

@@ -43,7 +43,7 @@ If you only want to use the `pandas` converter for `datetime64` values ::
 Find all objects in a figure of a certain type
 ----------------------------------------------
 
-Every Matplotlib artist (see :ref:`sphx_glr_tutorials_intermediate_artists.py`) has a method
+Every Matplotlib artist (see :doc:`/tutorials/intermediate/artists`) has a method
 called :meth:`~matplotlib.artist.Artist.findobj` that can be used to
 recursively search the artist for any artists it may contain that meet
 some criteria (e.g., match all :class:`~matplotlib.lines.Line2D`
@@ -159,7 +159,7 @@ labels::
     ax = fig.add_subplot(111)
 
 You can control the defaults for these parameters in your
-:file:`matplotlibrc` file; see :ref:`sphx_glr_tutorials_introductory_customizing.py`.  For
+:file:`matplotlibrc` file; see :doc:`/tutorials/introductory/customizing`.  For
 example, to make the above setting permanent, you would set::
 
     figure.subplot.bottom : 0.2   # the bottom of the subplots of the figure
@@ -190,7 +190,7 @@ specify the location explicitly::
     ax = fig.add_axes([left, bottom, width, height])
 
 where all values are in fractional (0 to 1) coordinates.  See
-:ref:`sphx_glr_gallery_subplots_axes_and_figures_axes_demo.py` for an example of placing axes manually.
+:doc:`/gallery/subplots_axes_and_figures/axes_demo` for an example of placing axes manually.
 
 .. _howto-auto-adjust:
 
@@ -200,7 +200,7 @@ Automatically make room for tick labels
 .. note::
    This is now easier to handle than ever before.
    Calling :func:`~matplotlib.pyplot.tight_layout` can fix many common
-   layout issues. See the :ref:`sphx_glr_tutorials_intermediate_tight_layout_guide.py`.
+   layout issues. See the :doc:`/tutorials/intermediate/tight_layout_guide`.
 
    The information below is kept here in case it is useful for other
    purposes.
@@ -352,7 +352,7 @@ and patches, respectively::
 
 .. only:: html
 
-    See :ref:`sphx_glr_gallery_misc_zorder_demo.py` for a complete example.
+    See :doc:`/gallery/misc/zorder_demo` for a complete example.
 
 You can also use the Axes property
 :meth:`~matplotlib.axes.Axes.set_axisbelow` to control whether the grid
@@ -371,7 +371,7 @@ some ratio which controls the ratio::
 
 .. only:: html
 
-    See :ref:`sphx_glr_gallery_subplots_axes_and_figures_axis_equal_demo.py` for a
+    See :doc:`/gallery/subplots_axes_and_figures/axis_equal_demo` for a
     complete example.
 
 .. _howto-twoscale:
@@ -415,7 +415,7 @@ locators as desired because the two axes are independent.
 
 .. only:: html
 
-    See :ref:`sphx_glr_gallery_api_two_scales.py` for a complete example
+    See :doc:`/gallery/api/two_scales` for a complete example
 
 .. _howto-batch:
 
@@ -661,7 +661,7 @@ For more on configuring your backend, see
 
 Alternatively, you can avoid pylab/pyplot altogether, which will give
 you a little more control, by calling the API directly as shown in
-:ref:`sphx_glr_gallery_api_agg_oo_sgskip.py`.
+:doc:`/gallery/api/agg_oo_sgskip`.
 
 You can either generate hardcopy on the filesystem by calling savefig::
 

doc/faq/installing_faq.rst

@@ -26,7 +26,7 @@ example::
 
 This will give you additional information about which backends matplotlib is
 loading, version information, and more. At this point you might want to make
-sure you understand matplotlib's :ref:`configuration <sphx_glr_tutorials_introductory_customizing.py>`
+sure you understand matplotlib's :doc:`configuration </tutorials/introductory/customizing>`
 process, governed by the :file:`matplotlibrc` configuration file which contains
 instructions within and the concept of the matplotlib backend.
 

doc/faq/troubleshooting_faq.rst

@@ -104,7 +104,7 @@ provide the following information in your e-mail to the `mailing list
   `Enthought Canopy <https://www.enthought.com/products/canopy/>`_).
 
 * Any customizations to your ``matplotlibrc`` file (see
-  :ref:`sphx_glr_tutorials_introductory_customizing.py`).
+  :doc:`/tutorials/introductory/customizing`).
 
 * If the problem is reproducible, please try to provide a *minimal*, standalone
   Python script that demonstrates the problem.  This is *the* critical step.

doc/users/dflt_style_changes.rst

@@ -96,7 +96,7 @@ are only specified via hex values.  To access these colors outside of
 the property cycling the notation for colors ``'CN'``, where ``N``
 takes values 0-9, was added to
 denote the first 10 colors in ``mpl.rcParams['axes.prop_cycle']`` See
-:ref:`sphx_glr_tutorials_colors_colors.py` for more details.
+:doc:`/tutorials/colors/colors` for more details.
 
 To restore the old color cycle use
 
@@ -145,7 +145,7 @@ watch Nathaniel Smith and Stéfan van der Walt's talk from SciPy2015.
 See `here for many more details <https://bids.github.io/colormap/>`__
 about the other alternatives and the tools used to create the color
 map.  For details on all of the color maps available in matplotlib see
-:ref:`sphx_glr_tutorials_colors_colormaps.py`.
+:doc:`/tutorials/colors/colormaps`.
 
 .. raw:: html
 

doc/users/prev_whats_new/whats_new_0.98.4.rst

@@ -79,7 +79,7 @@ psd amplitude scaling
 
 Ryan May did a lot of work to rationalize the amplitude scaling of
 :func:`~matplotlib.pyplot.psd` and friends.  See
-:ref:`sphx_glr_gallery_lines_bars_and_markers_psd_demo.py`.
+:doc:`/gallery/lines_bars_and_markers/psd_demo`.
 The changes should increase MATLAB
 compatibility and increase scaling options.