From 9be0e2dbf4f6494efb6b42078638e869255e7dd2 Mon Sep 17 00:00:00 2001
From: Erik Faye-Lund <erik.faye-lund@collabora.com>
Date: Mon, 15 Jun 2020 12:31:36 +0200
Subject: [PATCH] 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: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/5471>
---
 docs/application-issues.rst |   2 +-
 docs/download.rst           |   4 +-
 docs/egl.rst                |   2 +-
 docs/envvars.rst            |  14 +-
 docs/faq.rst                |   4 +-
 docs/install.rst            |   2 +-
 docs/opengles.rst           |   4 +-
 docs/release-calendar.rst   |   4 +-
 docs/releasing.rst          |   8 +-
 docs/relnotes.rst           | 544 ++++++++++++++++++------------------
 10 files changed, 294 insertions(+), 294 deletions(-)

diff --git a/docs/application-issues.rst b/docs/application-issues.rst
index a1efb5cbbd8..ab08e9feea6 100644
--- a/docs/application-issues.rst
+++ b/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.
diff --git a/docs/download.rst b/docs/download.rst
index ce723fe91b8..06a967aa3a6 100644
--- a/docs/download.rst
+++ b/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
 --------------------
diff --git a/docs/egl.rst b/docs/egl.rst
index a92cb615f91..ade5806d520 100644
--- a/docs/egl.rst
+++ b/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.
 
diff --git a/docs/envvars.rst b/docs/envvars.rst
index 68cd1200eff..5c9e851da8b 100644
--- a/docs/envvars.rst
+++ b/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
 -----------------------------
diff --git a/docs/faq.rst b/docs/faq.rst
index 5e2dc09cde0..edeca5392a6 100644
--- a/docs/faq.rst
+++ b/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
diff --git a/docs/install.rst b/docs/install.rst
index 40d20ed3b8f..bac818b2d8f 100644
--- a/docs/install.rst
+++ b/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)
diff --git a/docs/opengles.rst b/docs/opengles.rst
index e6cd0279748..a07d77823ff 100644
--- a/docs/opengles.rst
+++ b/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
 -------------------
diff --git a/docs/release-calendar.rst b/docs/release-calendar.rst
index 271b6383ad6..c2c6722a3d8 100644
--- a/docs/release-calendar.rst
+++ b/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:
diff --git a/docs/releasing.rst b/docs/releasing.rst
index da24c7a1e61..435732767a2 100644
--- a/docs/releasing.rst
+++ b/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)
diff --git a/docs/relnotes.rst b/docs/relnotes.rst
index 939476c9c5a..83501912829 100644
--- a/docs/relnotes.rst
+++ b/docs/relnotes.rst
@@ -3,279 +3,279 @@ Release Notes
 
 The release notes summarize what's new or changed in each Mesa release.
 
--  `20.0.8 release notes <relnotes/20.0.8.rst>`__
--  `20.1.1 release notes <relnotes/20.1.1.rst>`__
--  `20.1.0 release notes <relnotes/20.1.0.rst>`__
--  `20.0.7 release notes <relnotes/20.0.7.rst>`__
--  `20.0.6 release notes <relnotes/20.0.6.rst>`__
--  `20.0.5 release notes <relnotes/20.0.5.rst>`__
--  `20.0.4 release notes <relnotes/20.0.4.rst>`__
--  `20.0.3 release notes <relnotes/20.0.3.rst>`__
--  `20.0.2 release notes <relnotes/20.0.2.rst>`__
--  `19.3.5 release notes <relnotes/19.3.5.rst>`__
--  `20.0.1 release notes <relnotes/20.0.1.rst>`__
--  `20.0.0 release notes <relnotes/20.0.0.rst>`__
--  `19.3.4 release notes <relnotes/19.3.4.rst>`__
--  `19.3.3 release notes <relnotes/19.3.3.rst>`__
--  `19.3.2 release notes <relnotes/19.3.2.rst>`__
--  `19.2.8 release notes <relnotes/19.2.8.rst>`__
--  `19.3.1 release notes <relnotes/19.3.1.rst>`__
--  `19.3.0 release notes <relnotes/19.3.0.rst>`__
--  `19.2.7 release notes <relnotes/19.2.7.rst>`__
--  `19.2.6 release notes <relnotes/19.2.6.rst>`__
--  `19.2.5 release notes <relnotes/19.2.5.rst>`__
--  `19.2.4 release notes <relnotes/19.2.4.rst>`__
--  `19.2.3 release notes <relnotes/19.2.3.rst>`__
--  `19.2.2 release notes <relnotes/19.2.2.rst>`__
--  `19.1.8 release notes <relnotes/19.1.8.rst>`__
--  `19.2.1 release notes <relnotes/19.2.1.rst>`__
--  `19.2.0 release notes <relnotes/19.2.0.rst>`__
--  `19.1.7 release notes <relnotes/19.1.7.rst>`__
--  `19.1.6 release notes <relnotes/19.1.6.rst>`__
--  `19.1.5 release notes <relnotes/19.1.5.rst>`__
--  `19.1.4 release notes <relnotes/19.1.4.rst>`__
--  `19.1.3 release notes <relnotes/19.1.3.rst>`__
--  `19.1.2 release notes <relnotes/19.1.2.rst>`__
--  `19.0.8 release notes <relnotes/19.0.8.rst>`__
--  `19.1.1 release notes <relnotes/19.1.1.rst>`__
--  `19.0.7 release notes <relnotes/19.0.7.rst>`__
--  `19.1.0 release notes <relnotes/19.1.0.rst>`__
--  `19.0.6 release notes <relnotes/19.0.6.rst>`__
--  `19.0.5 release notes <relnotes/19.0.5.rst>`__
--  `19.0.4 release notes <relnotes/19.0.4.rst>`__
--  `19.0.3 release notes <relnotes/19.0.3.rst>`__
--  `19.0.2 release notes <relnotes/19.0.2.rst>`__
--  `18.3.6 release notes <relnotes/18.3.6.rst>`__
--  `19.0.1 release notes <relnotes/19.0.1.rst>`__
--  `18.3.5 release notes <relnotes/18.3.5.rst>`__
--  `19.0.0 release notes <relnotes/19.0.0.rst>`__
--  `18.3.4 release notes <relnotes/18.3.4.rst>`__
--  `18.3.3 release notes <relnotes/18.3.3.rst>`__
--  `18.3.2 release notes <relnotes/18.3.2.rst>`__
--  `18.2.8 release notes <relnotes/18.2.8.rst>`__
--  `18.2.7 release notes <relnotes/18.2.7.rst>`__
--  `18.3.1 release notes <relnotes/18.3.1.rst>`__
--  `18.3.0 release notes <relnotes/18.3.0.rst>`__
--  `18.2.6 release notes <relnotes/18.2.6.rst>`__
--  `18.2.5 release notes <relnotes/18.2.5.rst>`__
--  `18.2.4 release notes <relnotes/18.2.4.rst>`__
--  `18.2.3 release notes <relnotes/18.2.3.rst>`__
--  `18.2.2 release notes <relnotes/18.2.2.rst>`__
--  `18.1.9 release notes <relnotes/18.1.9.rst>`__
--  `18.2.1 release notes <relnotes/18.2.1.rst>`__
--  `18.2.0 release notes <relnotes/18.2.0.rst>`__
--  `18.1.8 release notes <relnotes/18.1.8.rst>`__
--  `18.1.7 release notes <relnotes/18.1.7.rst>`__
--  `18.1.6 release notes <relnotes/18.1.6.rst>`__
--  `18.1.5 release notes <relnotes/18.1.5.rst>`__
--  `18.1.4 release notes <relnotes/18.1.4.rst>`__
--  `18.1.3 release notes <relnotes/18.1.3.rst>`__
--  `18.1.2 release notes <relnotes/18.1.2.rst>`__
--  `18.0.5 release notes <relnotes/18.0.5.rst>`__
--  `18.1.1 release notes <relnotes/18.1.1.rst>`__
--  `18.1.0 release notes <relnotes/18.1.0.rst>`__
--  `18.0.4 release notes <relnotes/18.0.4.rst>`__
--  `18.0.3 release notes <relnotes/18.0.3.rst>`__
--  `18.0.2 release notes <relnotes/18.0.2.rst>`__
--  `18.0.1 release notes <relnotes/18.0.1.rst>`__
--  `17.3.9 release notes <relnotes/17.3.9.rst>`__
--  `17.3.8 release notes <relnotes/17.3.8.rst>`__
--  `18.0.0 release notes <relnotes/18.0.0.rst>`__
--  `17.3.7 release notes <relnotes/17.3.7.rst>`__
--  `17.3.6 release notes <relnotes/17.3.6.rst>`__
--  `17.3.5 release notes <relnotes/17.3.5.rst>`__
--  `17.3.4 release notes <relnotes/17.3.4.rst>`__
--  `17.3.3 release notes <relnotes/17.3.3.rst>`__
--  `17.3.2 release notes <relnotes/17.3.2.rst>`__
--  `17.2.8 release notes <relnotes/17.2.8.rst>`__
--  `17.3.1 release notes <relnotes/17.3.1.rst>`__
--  `17.2.7 release notes <relnotes/17.2.7.rst>`__
--  `17.3.0 release notes <relnotes/17.3.0.rst>`__
--  `17.2.6 release notes <relnotes/17.2.6.rst>`__
--  `17.2.5 release notes <relnotes/17.2.5.rst>`__
--  `17.2.4 release notes <relnotes/17.2.4.rst>`__
--  `17.2.3 release notes <relnotes/17.2.3.rst>`__
--  `17.2.2 release notes <relnotes/17.2.2.rst>`__
--  `17.1.10 release notes <relnotes/17.1.10.rst>`__
--  `17.2.1 release notes <relnotes/17.2.1.rst>`__
--  `17.1.9 release notes <relnotes/17.1.9.rst>`__
--  `17.2.0 release notes <relnotes/17.2.0.rst>`__
--  `17.1.8 release notes <relnotes/17.1.8.rst>`__
--  `17.1.7 release notes <relnotes/17.1.7.rst>`__
--  `17.1.6 release notes <relnotes/17.1.6.rst>`__
--  `17.1.5 release notes <relnotes/17.1.5.rst>`__
--  `17.1.4 release notes <relnotes/17.1.4.rst>`__
--  `17.1.3 release notes <relnotes/17.1.3.rst>`__
--  `17.1.2 release notes <relnotes/17.1.2.rst>`__
--  `17.0.7 release notes <relnotes/17.0.7.rst>`__
--  `17.1.1 release notes <relnotes/17.1.1.rst>`__
--  `17.0.6 release notes <relnotes/17.0.6.rst>`__
--  `17.1.0 release notes <relnotes/17.1.0.rst>`__
--  `17.0.5 release notes <relnotes/17.0.5.rst>`__
--  `17.0.4 release notes <relnotes/17.0.4.rst>`__
--  `17.0.3 release notes <relnotes/17.0.3.rst>`__
--  `17.0.2 release notes <relnotes/17.0.2.rst>`__
--  `13.0.6 release notes <relnotes/13.0.6.rst>`__
--  `17.0.1 release notes <relnotes/17.0.1.rst>`__
--  `13.0.5 release notes <relnotes/13.0.5.rst>`__
--  `17.0.0 release notes <relnotes/17.0.0.rst>`__
--  `13.0.4 release notes <relnotes/13.0.4.rst>`__
--  `12.0.6 release notes <relnotes/12.0.6.rst>`__
--  `13.0.3 release notes <relnotes/13.0.3.rst>`__
--  `12.0.5 release notes <relnotes/12.0.5.rst>`__
--  `13.0.2 release notes <relnotes/13.0.2.rst>`__
--  `13.0.1 release notes <relnotes/13.0.1.rst>`__
--  `12.0.4 release notes <relnotes/12.0.4.rst>`__
--  `13.0.0 release notes <relnotes/13.0.0.rst>`__
--  `12.0.3 release notes <relnotes/12.0.3.rst>`__
--  `12.0.2 release notes <relnotes/12.0.2.rst>`__
--  `12.0.1 release notes <relnotes/12.0.1.rst>`__
--  `12.0.0 release notes <relnotes/12.0.0.rst>`__
--  `11.2.2 release notes <relnotes/11.2.2.rst>`__
--  `11.1.4 release notes <relnotes/11.1.4.rst>`__
--  `11.2.1 release notes <relnotes/11.2.1.rst>`__
--  `11.1.3 release notes <relnotes/11.1.3.rst>`__
--  `11.2.0 release notes <relnotes/11.2.0.rst>`__
--  `11.1.2 release notes <relnotes/11.1.2.rst>`__
--  `11.0.9 release notes <relnotes/11.0.9.rst>`__
--  `11.1.1 release notes <relnotes/11.1.1.rst>`__
--  `11.0.8 release notes <relnotes/11.0.8.rst>`__
--  `11.1.0 release notes <relnotes/11.1.0.rst>`__
--  `11.0.7 release notes <relnotes/11.0.7.rst>`__
--  `11.0.6 release notes <relnotes/11.0.6.rst>`__
--  `11.0.5 release notes <relnotes/11.0.5.rst>`__
--  `11.0.4 release notes <relnotes/11.0.4.rst>`__
--  `11.0.3 release notes <relnotes/11.0.3.rst>`__
--  `10.6.9 release notes <relnotes/10.6.9.rst>`__
--  `11.0.2 release notes <relnotes/11.0.2.rst>`__
--  `11.0.1 release notes <relnotes/11.0.1.rst>`__
--  `10.6.8 release notes <relnotes/10.6.8.rst>`__
--  `11.0.0 release notes <relnotes/11.0.0.rst>`__
--  `10.6.7 release notes <relnotes/10.6.7.rst>`__
--  `10.6.6 release notes <relnotes/10.6.6.rst>`__
--  `10.6.5 release notes <relnotes/10.6.5.rst>`__
--  `10.6.4 release notes <relnotes/10.6.4.rst>`__
--  `10.6.3 release notes <relnotes/10.6.3.rst>`__
--  `10.6.2 release notes <relnotes/10.6.2.rst>`__
--  `10.5.9 release notes <relnotes/10.5.9.rst>`__
--  `10.6.1 release notes <relnotes/10.6.1.rst>`__
--  `10.5.8 release notes <relnotes/10.5.8.rst>`__
--  `10.6.0 release notes <relnotes/10.6.0.rst>`__
--  `10.5.7 release notes <relnotes/10.5.7.rst>`__
--  `10.5.6 release notes <relnotes/10.5.6.rst>`__
--  `10.5.5 release notes <relnotes/10.5.5.rst>`__
--  `10.5.4 release notes <relnotes/10.5.4.rst>`__
--  `10.5.3 release notes <relnotes/10.5.3.rst>`__
--  `10.5.2 release notes <relnotes/10.5.2.rst>`__
--  `10.4.7 release notes <relnotes/10.4.7.rst>`__
--  `10.5.1 release notes <relnotes/10.5.1.rst>`__
--  `10.5.0 release notes <relnotes/10.5.0.rst>`__
--  `10.4.6 release notes <relnotes/10.4.6.rst>`__
--  `10.4.5 release notes <relnotes/10.4.5.rst>`__
--  `10.4.4 release notes <relnotes/10.4.4.rst>`__
--  `10.4.3 release notes <relnotes/10.4.3.rst>`__
--  `10.4.2 release notes <relnotes/10.4.2.rst>`__
--  `10.3.7 release notes <relnotes/10.3.7.rst>`__
--  `10.4.1 release notes <relnotes/10.4.1.rst>`__
--  `10.3.6 release notes <relnotes/10.3.6.rst>`__
--  `10.4 release notes <relnotes/10.4.rst>`__
--  `10.3.5 release notes <relnotes/10.3.5.rst>`__
--  `10.3.4 release notes <relnotes/10.3.4.rst>`__
--  `10.3.3 release notes <relnotes/10.3.3.rst>`__
--  `10.3.2 release notes <relnotes/10.3.2.rst>`__
--  `10.3.1 release notes <relnotes/10.3.1.rst>`__
--  `10.2.9 release notes <relnotes/10.2.9.rst>`__
--  `10.3 release notes <relnotes/10.3.rst>`__
--  `10.2.8 release notes <relnotes/10.2.8.rst>`__
--  `10.2.7 release notes <relnotes/10.2.7.rst>`__
--  `10.2.6 release notes <relnotes/10.2.6.rst>`__
--  `10.2.5 release notes <relnotes/10.2.5.rst>`__
--  `10.2.4 release notes <relnotes/10.2.4.rst>`__
--  `10.2.3 release notes <relnotes/10.2.3.rst>`__
--  `10.2.2 release notes <relnotes/10.2.2.rst>`__
--  `10.2.1 release notes <relnotes/10.2.1.rst>`__
--  `10.2 release notes <relnotes/10.2.rst>`__
--  `10.1.6 release notes <relnotes/10.1.6.rst>`__
--  `10.1.5 release notes <relnotes/10.1.5.rst>`__
--  `10.1.4 release notes <relnotes/10.1.4.rst>`__
--  `10.1.3 release notes <relnotes/10.1.3.rst>`__
--  `10.1.2 release notes <relnotes/10.1.2.rst>`__
--  `10.1.1 release notes <relnotes/10.1.1.rst>`__
--  `10.1 release notes <relnotes/10.1.rst>`__
--  `10.0.5 release notes <relnotes/10.0.5.rst>`__
--  `10.0.4 release notes <relnotes/10.0.4.rst>`__
--  `10.0.3 release notes <relnotes/10.0.3.rst>`__
--  `10.0.2 release notes <relnotes/10.0.2.rst>`__
--  `10.0.1 release notes <relnotes/10.0.1.rst>`__
--  `10.0 release notes <relnotes/10.0.rst>`__
--  `9.2.5 release notes <relnotes/9.2.5.rst>`__
--  `9.2.4 release notes <relnotes/9.2.4.rst>`__
--  `9.2.3 release notes <relnotes/9.2.3.rst>`__
--  `9.2.2 release notes <relnotes/9.2.2.rst>`__
--  `9.2.1 release notes <relnotes/9.2.1.rst>`__
--  `9.2 release notes <relnotes/9.2.rst>`__
--  `9.1.7 release notes <relnotes/9.1.7.rst>`__
--  `9.1.6 release notes <relnotes/9.1.6.rst>`__
--  `9.1.5 release notes <relnotes/9.1.5.rst>`__
--  `9.1.4 release notes <relnotes/9.1.4.rst>`__
--  `9.1.3 release notes <relnotes/9.1.3.rst>`__
--  `9.1.2 release notes <relnotes/9.1.2.rst>`__
--  `9.1.1 release notes <relnotes/9.1.1.rst>`__
--  `9.1 release notes <relnotes/9.1.rst>`__
--  `9.0.3 release notes <relnotes/9.0.3.rst>`__
--  `9.0.2 release notes <relnotes/9.0.2.rst>`__
--  `9.0.1 release notes <relnotes/9.0.1.rst>`__
--  `9.0 release notes <relnotes/9.0.rst>`__
--  `8.0.5 release notes <relnotes/8.0.5.rst>`__
--  `8.0.4 release notes <relnotes/8.0.4.rst>`__
--  `8.0.3 release notes <relnotes/8.0.3.rst>`__
--  `8.0.2 release notes <relnotes/8.0.2.rst>`__
--  `8.0.1 release notes <relnotes/8.0.1.rst>`__
--  `8.0 release notes <relnotes/8.0.rst>`__
--  `7.11.2 release notes <relnotes/7.11.2.rst>`__
--  `7.11.1 release notes <relnotes/7.11.1.rst>`__
--  `7.11 release notes <relnotes/7.11.rst>`__
--  `7.10.3 release notes <relnotes/7.10.3.rst>`__
--  `7.10.2 release notes <relnotes/7.10.2.rst>`__
--  `7.10.1 release notes <relnotes/7.10.1.rst>`__
--  `7.10 release notes <relnotes/7.10.rst>`__
--  `7.9.2 release notes <relnotes/7.9.2.rst>`__
--  `7.9.1 release notes <relnotes/7.9.1.rst>`__
--  `7.9 release notes <relnotes/7.9.rst>`__
--  `7.8.3 release notes <relnotes/7.8.3.rst>`__
--  `7.8.2 release notes <relnotes/7.8.2.rst>`__
--  `7.8.1 release notes <relnotes/7.8.1.rst>`__
--  `7.8 release notes <relnotes/7.8.rst>`__
--  `7.7.1 release notes <relnotes/7.7.1.rst>`__
--  `7.7 release notes <relnotes/7.7.rst>`__
--  `7.6.1 release notes <relnotes/7.6.1.rst>`__
--  `7.6 release notes <relnotes/7.6.rst>`__
--  `7.5.2 release notes <relnotes/7.5.2.rst>`__
--  `7.5.1 release notes <relnotes/7.5.1.rst>`__
--  `7.5 release notes <relnotes/7.5.rst>`__
--  `7.4.4 release notes <relnotes/7.4.4.rst>`__
--  `7.4.3 release notes <relnotes/7.4.3.rst>`__
--  `7.4.2 release notes <relnotes/7.4.2.rst>`__
--  `7.4.1 release notes <relnotes/7.4.1.rst>`__
--  `7.4 release notes <relnotes/7.4.rst>`__
--  `7.3 release notes <relnotes/7.3.rst>`__
--  `7.2 release notes <relnotes/7.2.rst>`__
--  `7.1 release notes <relnotes/7.1.rst>`__
--  `7.0.4 release notes <relnotes/7.0.4.rst>`__
--  `7.0.3 release notes <relnotes/7.0.3.rst>`__
--  `7.0.2 release notes <relnotes/7.0.2.rst>`__
--  `7.0.1 release notes <relnotes/7.0.1.rst>`__
--  `7.0 release notes <relnotes/7.0.rst>`__
--  `6.5.3 release notes <relnotes/6.5.3.rst>`__
--  `6.5.2 release notes <relnotes/6.5.2.rst>`__
--  `6.5.1 release notes <relnotes/6.5.1.rst>`__
--  `6.5 release notes <relnotes/6.5.rst>`__
--  `6.4.2 release notes <relnotes/6.4.2.rst>`__
--  `6.4.1 release notes <relnotes/6.4.1.rst>`__
--  `6.4 release notes <relnotes/6.4.rst>`__
+-  :doc:`20.0.8 release notes <relnotes/20.0.8>`
+-  :doc:`20.1.1 release notes <relnotes/20.1.1>`
+-  :doc:`20.1.0 release notes <relnotes/20.1.0>`
+-  :doc:`20.0.7 release notes <relnotes/20.0.7>`
+-  :doc:`20.0.6 release notes <relnotes/20.0.6>`
+-  :doc:`20.0.5 release notes <relnotes/20.0.5>`
+-  :doc:`20.0.4 release notes <relnotes/20.0.4>`
+-  :doc:`20.0.3 release notes <relnotes/20.0.3>`
+-  :doc:`20.0.2 release notes <relnotes/20.0.2>`
+-  :doc:`19.3.5 release notes <relnotes/19.3.5>`
+-  :doc:`20.0.1 release notes <relnotes/20.0.1>`
+-  :doc:`20.0.0 release notes <relnotes/20.0.0>`
+-  :doc:`19.3.4 release notes <relnotes/19.3.4>`
+-  :doc:`19.3.3 release notes <relnotes/19.3.3>`
+-  :doc:`19.3.2 release notes <relnotes/19.3.2>`
+-  :doc:`19.2.8 release notes <relnotes/19.2.8>`
+-  :doc:`19.3.1 release notes <relnotes/19.3.1>`
+-  :doc:`19.3.0 release notes <relnotes/19.3.0>`
+-  :doc:`19.2.7 release notes <relnotes/19.2.7>`
+-  :doc:`19.2.6 release notes <relnotes/19.2.6>`
+-  :doc:`19.2.5 release notes <relnotes/19.2.5>`
+-  :doc:`19.2.4 release notes <relnotes/19.2.4>`
+-  :doc:`19.2.3 release notes <relnotes/19.2.3>`
+-  :doc:`19.2.2 release notes <relnotes/19.2.2>`
+-  :doc:`19.1.8 release notes <relnotes/19.1.8>`
+-  :doc:`19.2.1 release notes <relnotes/19.2.1>`
+-  :doc:`19.2.0 release notes <relnotes/19.2.0>`
+-  :doc:`19.1.7 release notes <relnotes/19.1.7>`
+-  :doc:`19.1.6 release notes <relnotes/19.1.6>`
+-  :doc:`19.1.5 release notes <relnotes/19.1.5>`
+-  :doc:`19.1.4 release notes <relnotes/19.1.4>`
+-  :doc:`19.1.3 release notes <relnotes/19.1.3>`
+-  :doc:`19.1.2 release notes <relnotes/19.1.2>`
+-  :doc:`19.0.8 release notes <relnotes/19.0.8>`
+-  :doc:`19.1.1 release notes <relnotes/19.1.1>`
+-  :doc:`19.0.7 release notes <relnotes/19.0.7>`
+-  :doc:`19.1.0 release notes <relnotes/19.1.0>`
+-  :doc:`19.0.6 release notes <relnotes/19.0.6>`
+-  :doc:`19.0.5 release notes <relnotes/19.0.5>`
+-  :doc:`19.0.4 release notes <relnotes/19.0.4>`
+-  :doc:`19.0.3 release notes <relnotes/19.0.3>`
+-  :doc:`19.0.2 release notes <relnotes/19.0.2>`
+-  :doc:`18.3.6 release notes <relnotes/18.3.6>`
+-  :doc:`19.0.1 release notes <relnotes/19.0.1>`
+-  :doc:`18.3.5 release notes <relnotes/18.3.5>`
+-  :doc:`19.0.0 release notes <relnotes/19.0.0>`
+-  :doc:`18.3.4 release notes <relnotes/18.3.4>`
+-  :doc:`18.3.3 release notes <relnotes/18.3.3>`
+-  :doc:`18.3.2 release notes <relnotes/18.3.2>`
+-  :doc:`18.2.8 release notes <relnotes/18.2.8>`
+-  :doc:`18.2.7 release notes <relnotes/18.2.7>`
+-  :doc:`18.3.1 release notes <relnotes/18.3.1>`
+-  :doc:`18.3.0 release notes <relnotes/18.3.0>`
+-  :doc:`18.2.6 release notes <relnotes/18.2.6>`
+-  :doc:`18.2.5 release notes <relnotes/18.2.5>`
+-  :doc:`18.2.4 release notes <relnotes/18.2.4>`
+-  :doc:`18.2.3 release notes <relnotes/18.2.3>`
+-  :doc:`18.2.2 release notes <relnotes/18.2.2>`
+-  :doc:`18.1.9 release notes <relnotes/18.1.9>`
+-  :doc:`18.2.1 release notes <relnotes/18.2.1>`
+-  :doc:`18.2.0 release notes <relnotes/18.2.0>`
+-  :doc:`18.1.8 release notes <relnotes/18.1.8>`
+-  :doc:`18.1.7 release notes <relnotes/18.1.7>`
+-  :doc:`18.1.6 release notes <relnotes/18.1.6>`
+-  :doc:`18.1.5 release notes <relnotes/18.1.5>`
+-  :doc:`18.1.4 release notes <relnotes/18.1.4>`
+-  :doc:`18.1.3 release notes <relnotes/18.1.3>`
+-  :doc:`18.1.2 release notes <relnotes/18.1.2>`
+-  :doc:`18.0.5 release notes <relnotes/18.0.5>`
+-  :doc:`18.1.1 release notes <relnotes/18.1.1>`
+-  :doc:`18.1.0 release notes <relnotes/18.1.0>`
+-  :doc:`18.0.4 release notes <relnotes/18.0.4>`
+-  :doc:`18.0.3 release notes <relnotes/18.0.3>`
+-  :doc:`18.0.2 release notes <relnotes/18.0.2>`
+-  :doc:`18.0.1 release notes <relnotes/18.0.1>`
+-  :doc:`17.3.9 release notes <relnotes/17.3.9>`
+-  :doc:`17.3.8 release notes <relnotes/17.3.8>`
+-  :doc:`18.0.0 release notes <relnotes/18.0.0>`
+-  :doc:`17.3.7 release notes <relnotes/17.3.7>`
+-  :doc:`17.3.6 release notes <relnotes/17.3.6>`
+-  :doc:`17.3.5 release notes <relnotes/17.3.5>`
+-  :doc:`17.3.4 release notes <relnotes/17.3.4>`
+-  :doc:`17.3.3 release notes <relnotes/17.3.3>`
+-  :doc:`17.3.2 release notes <relnotes/17.3.2>`
+-  :doc:`17.2.8 release notes <relnotes/17.2.8>`
+-  :doc:`17.3.1 release notes <relnotes/17.3.1>`
+-  :doc:`17.2.7 release notes <relnotes/17.2.7>`
+-  :doc:`17.3.0 release notes <relnotes/17.3.0>`
+-  :doc:`17.2.6 release notes <relnotes/17.2.6>`
+-  :doc:`17.2.5 release notes <relnotes/17.2.5>`
+-  :doc:`17.2.4 release notes <relnotes/17.2.4>`
+-  :doc:`17.2.3 release notes <relnotes/17.2.3>`
+-  :doc:`17.2.2 release notes <relnotes/17.2.2>`
+-  :doc:`17.1.10 release notes <relnotes/17.1.10>`
+-  :doc:`17.2.1 release notes <relnotes/17.2.1>`
+-  :doc:`17.1.9 release notes <relnotes/17.1.9>`
+-  :doc:`17.2.0 release notes <relnotes/17.2.0>`
+-  :doc:`17.1.8 release notes <relnotes/17.1.8>`
+-  :doc:`17.1.7 release notes <relnotes/17.1.7>`
+-  :doc:`17.1.6 release notes <relnotes/17.1.6>`
+-  :doc:`17.1.5 release notes <relnotes/17.1.5>`
+-  :doc:`17.1.4 release notes <relnotes/17.1.4>`
+-  :doc:`17.1.3 release notes <relnotes/17.1.3>`
+-  :doc:`17.1.2 release notes <relnotes/17.1.2>`
+-  :doc:`17.0.7 release notes <relnotes/17.0.7>`
+-  :doc:`17.1.1 release notes <relnotes/17.1.1>`
+-  :doc:`17.0.6 release notes <relnotes/17.0.6>`
+-  :doc:`17.1.0 release notes <relnotes/17.1.0>`
+-  :doc:`17.0.5 release notes <relnotes/17.0.5>`
+-  :doc:`17.0.4 release notes <relnotes/17.0.4>`
+-  :doc:`17.0.3 release notes <relnotes/17.0.3>`
+-  :doc:`17.0.2 release notes <relnotes/17.0.2>`
+-  :doc:`13.0.6 release notes <relnotes/13.0.6>`
+-  :doc:`17.0.1 release notes <relnotes/17.0.1>`
+-  :doc:`13.0.5 release notes <relnotes/13.0.5>`
+-  :doc:`17.0.0 release notes <relnotes/17.0.0>`
+-  :doc:`13.0.4 release notes <relnotes/13.0.4>`
+-  :doc:`12.0.6 release notes <relnotes/12.0.6>`
+-  :doc:`13.0.3 release notes <relnotes/13.0.3>`
+-  :doc:`12.0.5 release notes <relnotes/12.0.5>`
+-  :doc:`13.0.2 release notes <relnotes/13.0.2>`
+-  :doc:`13.0.1 release notes <relnotes/13.0.1>`
+-  :doc:`12.0.4 release notes <relnotes/12.0.4>`
+-  :doc:`13.0.0 release notes <relnotes/13.0.0>`
+-  :doc:`12.0.3 release notes <relnotes/12.0.3>`
+-  :doc:`12.0.2 release notes <relnotes/12.0.2>`
+-  :doc:`12.0.1 release notes <relnotes/12.0.1>`
+-  :doc:`12.0.0 release notes <relnotes/12.0.0>`
+-  :doc:`11.2.2 release notes <relnotes/11.2.2>`
+-  :doc:`11.1.4 release notes <relnotes/11.1.4>`
+-  :doc:`11.2.1 release notes <relnotes/11.2.1>`
+-  :doc:`11.1.3 release notes <relnotes/11.1.3>`
+-  :doc:`11.2.0 release notes <relnotes/11.2.0>`
+-  :doc:`11.1.2 release notes <relnotes/11.1.2>`
+-  :doc:`11.0.9 release notes <relnotes/11.0.9>`
+-  :doc:`11.1.1 release notes <relnotes/11.1.1>`
+-  :doc:`11.0.8 release notes <relnotes/11.0.8>`
+-  :doc:`11.1.0 release notes <relnotes/11.1.0>`
+-  :doc:`11.0.7 release notes <relnotes/11.0.7>`
+-  :doc:`11.0.6 release notes <relnotes/11.0.6>`
+-  :doc:`11.0.5 release notes <relnotes/11.0.5>`
+-  :doc:`11.0.4 release notes <relnotes/11.0.4>`
+-  :doc:`11.0.3 release notes <relnotes/11.0.3>`
+-  :doc:`10.6.9 release notes <relnotes/10.6.9>`
+-  :doc:`11.0.2 release notes <relnotes/11.0.2>`
+-  :doc:`11.0.1 release notes <relnotes/11.0.1>`
+-  :doc:`10.6.8 release notes <relnotes/10.6.8>`
+-  :doc:`11.0.0 release notes <relnotes/11.0.0>`
+-  :doc:`10.6.7 release notes <relnotes/10.6.7>`
+-  :doc:`10.6.6 release notes <relnotes/10.6.6>`
+-  :doc:`10.6.5 release notes <relnotes/10.6.5>`
+-  :doc:`10.6.4 release notes <relnotes/10.6.4>`
+-  :doc:`10.6.3 release notes <relnotes/10.6.3>`
+-  :doc:`10.6.2 release notes <relnotes/10.6.2>`
+-  :doc:`10.5.9 release notes <relnotes/10.5.9>`
+-  :doc:`10.6.1 release notes <relnotes/10.6.1>`
+-  :doc:`10.5.8 release notes <relnotes/10.5.8>`
+-  :doc:`10.6.0 release notes <relnotes/10.6.0>`
+-  :doc:`10.5.7 release notes <relnotes/10.5.7>`
+-  :doc:`10.5.6 release notes <relnotes/10.5.6>`
+-  :doc:`10.5.5 release notes <relnotes/10.5.5>`
+-  :doc:`10.5.4 release notes <relnotes/10.5.4>`
+-  :doc:`10.5.3 release notes <relnotes/10.5.3>`
+-  :doc:`10.5.2 release notes <relnotes/10.5.2>`
+-  :doc:`10.4.7 release notes <relnotes/10.4.7>`
+-  :doc:`10.5.1 release notes <relnotes/10.5.1>`
+-  :doc:`10.5.0 release notes <relnotes/10.5.0>`
+-  :doc:`10.4.6 release notes <relnotes/10.4.6>`
+-  :doc:`10.4.5 release notes <relnotes/10.4.5>`
+-  :doc:`10.4.4 release notes <relnotes/10.4.4>`
+-  :doc:`10.4.3 release notes <relnotes/10.4.3>`
+-  :doc:`10.4.2 release notes <relnotes/10.4.2>`
+-  :doc:`10.3.7 release notes <relnotes/10.3.7>`
+-  :doc:`10.4.1 release notes <relnotes/10.4.1>`
+-  :doc:`10.3.6 release notes <relnotes/10.3.6>`
+-  :doc:`10.4 release notes <relnotes/10.4>`
+-  :doc:`10.3.5 release notes <relnotes/10.3.5>`
+-  :doc:`10.3.4 release notes <relnotes/10.3.4>`
+-  :doc:`10.3.3 release notes <relnotes/10.3.3>`
+-  :doc:`10.3.2 release notes <relnotes/10.3.2>`
+-  :doc:`10.3.1 release notes <relnotes/10.3.1>`
+-  :doc:`10.2.9 release notes <relnotes/10.2.9>`
+-  :doc:`10.3 release notes <relnotes/10.3>`
+-  :doc:`10.2.8 release notes <relnotes/10.2.8>`
+-  :doc:`10.2.7 release notes <relnotes/10.2.7>`
+-  :doc:`10.2.6 release notes <relnotes/10.2.6>`
+-  :doc:`10.2.5 release notes <relnotes/10.2.5>`
+-  :doc:`10.2.4 release notes <relnotes/10.2.4>`
+-  :doc:`10.2.3 release notes <relnotes/10.2.3>`
+-  :doc:`10.2.2 release notes <relnotes/10.2.2>`
+-  :doc:`10.2.1 release notes <relnotes/10.2.1>`
+-  :doc:`10.2 release notes <relnotes/10.2>`
+-  :doc:`10.1.6 release notes <relnotes/10.1.6>`
+-  :doc:`10.1.5 release notes <relnotes/10.1.5>`
+-  :doc:`10.1.4 release notes <relnotes/10.1.4>`
+-  :doc:`10.1.3 release notes <relnotes/10.1.3>`
+-  :doc:`10.1.2 release notes <relnotes/10.1.2>`
+-  :doc:`10.1.1 release notes <relnotes/10.1.1>`
+-  :doc:`10.1 release notes <relnotes/10.1>`
+-  :doc:`10.0.5 release notes <relnotes/10.0.5>`
+-  :doc:`10.0.4 release notes <relnotes/10.0.4>`
+-  :doc:`10.0.3 release notes <relnotes/10.0.3>`
+-  :doc:`10.0.2 release notes <relnotes/10.0.2>`
+-  :doc:`10.0.1 release notes <relnotes/10.0.1>`
+-  :doc:`10.0 release notes <relnotes/10.0>`
+-  :doc:`9.2.5 release notes <relnotes/9.2.5>`
+-  :doc:`9.2.4 release notes <relnotes/9.2.4>`
+-  :doc:`9.2.3 release notes <relnotes/9.2.3>`
+-  :doc:`9.2.2 release notes <relnotes/9.2.2>`
+-  :doc:`9.2.1 release notes <relnotes/9.2.1>`
+-  :doc:`9.2 release notes <relnotes/9.2>`
+-  :doc:`9.1.7 release notes <relnotes/9.1.7>`
+-  :doc:`9.1.6 release notes <relnotes/9.1.6>`
+-  :doc:`9.1.5 release notes <relnotes/9.1.5>`
+-  :doc:`9.1.4 release notes <relnotes/9.1.4>`
+-  :doc:`9.1.3 release notes <relnotes/9.1.3>`
+-  :doc:`9.1.2 release notes <relnotes/9.1.2>`
+-  :doc:`9.1.1 release notes <relnotes/9.1.1>`
+-  :doc:`9.1 release notes <relnotes/9.1>`
+-  :doc:`9.0.3 release notes <relnotes/9.0.3>`
+-  :doc:`9.0.2 release notes <relnotes/9.0.2>`
+-  :doc:`9.0.1 release notes <relnotes/9.0.1>`
+-  :doc:`9.0 release notes <relnotes/9.0>`
+-  :doc:`8.0.5 release notes <relnotes/8.0.5>`
+-  :doc:`8.0.4 release notes <relnotes/8.0.4>`
+-  :doc:`8.0.3 release notes <relnotes/8.0.3>`
+-  :doc:`8.0.2 release notes <relnotes/8.0.2>`
+-  :doc:`8.0.1 release notes <relnotes/8.0.1>`
+-  :doc:`8.0 release notes <relnotes/8.0>`
+-  :doc:`7.11.2 release notes <relnotes/7.11.2>`
+-  :doc:`7.11.1 release notes <relnotes/7.11.1>`
+-  :doc:`7.11 release notes <relnotes/7.11>`
+-  :doc:`7.10.3 release notes <relnotes/7.10.3>`
+-  :doc:`7.10.2 release notes <relnotes/7.10.2>`
+-  :doc:`7.10.1 release notes <relnotes/7.10.1>`
+-  :doc:`7.10 release notes <relnotes/7.10>`
+-  :doc:`7.9.2 release notes <relnotes/7.9.2>`
+-  :doc:`7.9.1 release notes <relnotes/7.9.1>`
+-  :doc:`7.9 release notes <relnotes/7.9>`
+-  :doc:`7.8.3 release notes <relnotes/7.8.3>`
+-  :doc:`7.8.2 release notes <relnotes/7.8.2>`
+-  :doc:`7.8.1 release notes <relnotes/7.8.1>`
+-  :doc:`7.8 release notes <relnotes/7.8>`
+-  :doc:`7.7.1 release notes <relnotes/7.7.1>`
+-  :doc:`7.7 release notes <relnotes/7.7>`
+-  :doc:`7.6.1 release notes <relnotes/7.6.1>`
+-  :doc:`7.6 release notes <relnotes/7.6>`
+-  :doc:`7.5.2 release notes <relnotes/7.5.2>`
+-  :doc:`7.5.1 release notes <relnotes/7.5.1>`
+-  :doc:`7.5 release notes <relnotes/7.5>`
+-  :doc:`7.4.4 release notes <relnotes/7.4.4>`
+-  :doc:`7.4.3 release notes <relnotes/7.4.3>`
+-  :doc:`7.4.2 release notes <relnotes/7.4.2>`
+-  :doc:`7.4.1 release notes <relnotes/7.4.1>`
+-  :doc:`7.4 release notes <relnotes/7.4>`
+-  :doc:`7.3 release notes <relnotes/7.3>`
+-  :doc:`7.2 release notes <relnotes/7.2>`
+-  :doc:`7.1 release notes <relnotes/7.1>`
+-  :doc:`7.0.4 release notes <relnotes/7.0.4>`
+-  :doc:`7.0.3 release notes <relnotes/7.0.3>`
+-  :doc:`7.0.2 release notes <relnotes/7.0.2>`
+-  :doc:`7.0.1 release notes <relnotes/7.0.1>`
+-  :doc:`7.0 release notes <relnotes/7.0>`
+-  :doc:`6.5.3 release notes <relnotes/6.5.3>`
+-  :doc:`6.5.2 release notes <relnotes/6.5.2>`
+-  :doc:`6.5.1 release notes <relnotes/6.5.1>`
+-  :doc:`6.5 release notes <relnotes/6.5>`
+-  :doc:`6.4.2 release notes <relnotes/6.4.2>`
+-  :doc:`6.4.1 release notes <relnotes/6.4.1>`
+-  :doc:`6.4 release notes <relnotes/6.4>`
 
-Versions of Mesa prior to 6.4 are summarized in the `versions
-file <versions.rst>`__ and the following release notes.
+Versions of Mesa prior to 6.4 are summarized in the :doc:`versions
+file <versions>` and the following release notes.
 
 -  `6.3.2 release notes <relnotes/6.3.2>`__
 -  `6.3.1 release notes <relnotes/6.3.1>`__
-- 
2.30.2