docs: update internal references

This time, let's use proper Sphinx roles for the referenes, so we can
reference documents and inline refs.

Reviewed-by: Eric Anholt <eric@anholt.net>
Part-of: <!5471>

docs/application-issues.rst

@@ -44,5 +44,5 @@ before running the game.
 Viewperf
 --------
 
-See the `Viewperf issues <viewperf.rst>`__ page for a detailed list of
+See the :doc:`Viewperf issues <viewperf>` page for a detailed list of
 Viewperf issues.

docs/download.rst

@@ -38,8 +38,8 @@ or
 Contents
 --------
 
-Proceed to the `compilation and installation
-instructions <install.rst>`__.
+Proceed to the :doc:`compilation and installation
+instructions <install>`.
 
 Demos, GLUT, and GLU
 --------------------

docs/egl.rst

@@ -28,7 +28,7 @@ Build EGL
               -D gallium-drivers=...
 
    The main library and OpenGL is enabled by default. The first two
-   options above enables `OpenGL ES 1.x and 2.x <opengles.rst>`__. The
+   options above enables :doc:`OpenGL ES 1.x and 2.x <opengles>`. The
    last two options enables the listed classic and Gallium drivers
    respectively.
 

docs/envvars.rst

@@ -163,14 +163,14 @@ Core Mesa environment variables
    variable is set), or else within ``.cache/mesa_shader_cache`` within
    the user's home directory.
 ``MESA_GLSL``
-   `shading language compiler options <shading.rst#envvars>`__
+   :ref:`shading language compiler options <envvars>`
 ``MESA_NO_MINMAX_CACHE``
    when set, the minmax index cache is globally disabled.
 ``MESA_SHADER_CAPTURE_PATH``
-   see `Capturing Shaders <shading.rst#capture>`__
+   see :ref:`Capturing Shaders <capture>`
 ``MESA_SHADER_DUMP_PATH`` and ``MESA_SHADER_READ_PATH``
-   see `Experimenting with Shader
-   Replacements <shading.rst#replacement>`__
+   see :ref:`Experimenting with Shader
+   Replacements <replacement>`
 ``MESA_VK_VERSION_OVERRIDE``
    changes the Vulkan physical device version as returned in
    ``VkPhysicalDeviceProperties::apiVersion``.
@@ -202,7 +202,7 @@ Mesa Xlib driver environment variables
 --------------------------------------
 
 The following are only applicable to the Mesa Xlib software driver. See
-the `Xlib software driver page <xlibdriver.rst>`__ for details.
+the :doc:`Xlib software driver page <xlibdriver>` for details.
 
 ``MESA_RGB_VISUAL``
    specifies the X visual and depth for RGB mode
@@ -341,8 +341,8 @@ Radeon driver environment variables (radeon, r200, and r300g)
 EGL environment variables
 -------------------------
 
-Mesa EGL supports different sets of environment variables. See the `Mesa
-EGL <egl.rst>`__ page for the details.
+Mesa EGL supports different sets of environment variables. See the
+:doc:`Mesa EGL <egl>` page for the details.
 
 Gallium environment variables
 -----------------------------

docs/faq.rst

@@ -85,7 +85,7 @@ drivers within the DRI (Direct Rendering Infrastructure):
 
 This wasn't easy in the past. Now, the DRI drivers are included in the
 Mesa tree and can be compiled separately from the X server. Just follow
-the Mesa `compilation instructions <install.rst>`__.
+the Mesa :doc:`compilation instructions <install>`.
 
 1.6 Are there other open-source implementations of OpenGL?
 ----------------------------------------------------------
@@ -262,7 +262,7 @@ problem.
 4.1 How can I contribute?
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-First, join the `mesa-dev mailing list <lists.rst>`__. That's where
+First, join the :doc:`mesa-dev mailing list <lists>`. That's where
 Mesa development is discussed.
 
 The `OpenGL Specification <https://www.opengl.org/documentation>`__ is

docs/install.rst

@@ -102,7 +102,7 @@ On windows you can also use the visual studio backend
      cd builddir
      msbuild mesa.sln /m
 
-Please read the `detailed meson instructions <meson.rst>`__ for more
+Please read the :doc:`detailed meson instructions <meson>` for more
 information
 
 3. Building with SCons (Windows/Linux)

docs/opengles.rst

@@ -4,8 +4,8 @@ OpenGL ES
 Mesa implements OpenGL ES 1.1 and OpenGL ES 2.0. More information about
 OpenGL ES can be found at https://www.khronos.org/opengles/.
 
-OpenGL ES depends on a working EGL implementation. Please refer to `Mesa
-EGL <egl.rst>`__ for more information about EGL.
+OpenGL ES depends on a working EGL implementation. Please refer to
+:doc:`Mesa EGL <egl>` for more information about EGL.
 
 Build the Libraries
 -------------------

docs/release-calendar.rst

@@ -17,9 +17,9 @@ used, best practices and other details, the member in charge of the next
 feature release will be in constant rotation.
 
 The way the release schedule works is explained
-`here <releasing.rst#schedule>`__.
+:ref:`here <schedule>`.
 
-Take a look `here <submittingpatches.rst#criteria>`__ if you'd like to
+Take a look :ref:`here <criteria>` if you'd like to
 nominate a patch in the next stable release.
 
 .. _calendar:

docs/releasing.rst

@@ -27,7 +27,7 @@ Release schedule
 Releases should happen on Wednesdays. Delays can occur although those
 should be kept to a minimum.
 
-See our `calendar <release-calendar.rst>`__ for information about how
+See our :doc:`calendar <release-calendar>` for information about how
 the release schedule is planned, and the date and other details for
 individual releases.
 
@@ -58,7 +58,7 @@ Stable releases
    This also involves that, as a final release may be delayed due to the
    need of additional candidates to solve some blocking regression(s), the
    release manager might have to update the
-   `calendar <release-calendar.rst>`__ with additional bug fix releases of
+   :doc:`calendar <release-calendar>` with additional bug fix releases of
    the current stable branch.
 
 .. _pickntest:
@@ -67,7 +67,7 @@ Cherry-picking and testing
 --------------------------
 
 Commits nominated for the active branch are picked as based on the
-`criteria <submittingpatches.rst#criteria>`__ as described in the same
+:ref:`criteria <criteria>` as described in the same
 section.
 
 Nominations happen via special tags in the commit messages, and via
@@ -214,7 +214,7 @@ Perform basic testing
 ~~~~~~~~~~~~~~~~~~~~~
 
 Most of the testing should already be done during the
-`cherry-pick <#pickntest>`__ So we do a quick 'touch test'
+:ref:`cherry-pick <pickntest>` So we do a quick 'touch test'
 
 -  meson dist
 -  scons (from release tarball)