------------
 
 Mesa 17.0.5 is expected in approximatelly two weeks. See the release
-`calendar <../release-calendar.rst#calendar>`__ for details.
+:ref:`calendar <calendar>` for details.
 
 New features
 ------------
 
 
 Mesa 17.1.0 is a new development release. People who are concerned with
 stability and reliability should stick with a previous release or wait
-for `Mesa 17.1.1 <../release-calendar.rst#calendar>`__.
+for :ref:`Mesa 17.1.1 <calendar>`.
 
 Mesa 17.1.0 implements the OpenGL 4.5 API, but the version reported by
 glGetString(GL_VERSION) or glGetIntegerv(GL_MAJOR_VERSION) /
 
 ------------
 
 -  OpenGL 2.0 and 2.1 API support.
--  Entirely new Shading Language code generator. See the `Shading
-   Language <../shading.rst>`__ page for more information.
+-  Entirely new Shading Language code generator. See the :doc:`Shading
+   Language <../shading>` page for more information.
 -  Much faster software execution of vertex, fragment shaders.
 -  New vertex buffer object (vbo) infrastructure
 -  Updated glext.h file (version 39)
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 Note that the Mesa project is no longer using odd/even version numbers
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 -  GL_EXT_texture_array extension (swrast driver only)
 -  GL_APPLE_object_purgeable extension (swrast and i945/i965 DRI
    drivers)
--  Much improved support for `EGL in Mesa <../egl.rst>`__
--  New state trackers for `OpenGL ES 1.1 and 2.0 <../opengles.rst>`__
+-  Much improved support for :doc:`EGL in Mesa <../egl>`
+-  New state trackers for :doc:`OpenGL ES 1.1 and 2.0 <../opengles>`
 -  Dedicated documentation for Gallium
 
 Bug fixes
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 2.1.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 New features
 ------------
 
--  New, improved GLSL compiler written by Intel. See the `Shading
-   Language <../shading.rst>`__ page for more information.
+-  New, improved GLSL compiler written by Intel. See the :doc:`Shading
+   Language <../shading>` page for more information.
 -  New, very experimental Gallium driver for R600-R700 Radeons.
 -  Support for AMD Evergreen-based Radeons (HD 5xxx)
 -  GL_EXT_timer_query extension (i965 driver and softpipe only)
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 3.0.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 3.0.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 3.0.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 3.0.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 3.0.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums
 
 glGetString(GL_VERSION) depends on the particular driver being used.
 Some drivers don't support all the features required in OpenGL 3.0.
 
-See the `Compiling/Installing page <../install.rst>`__ for
+See the :doc:`Compiling/Installing page <../install>` for
 prerequisites for DRI hardware acceleration.
 
 MD5 checksums