docs: Fix Sphinx compile errors.

This just involves some quick fixes to formatting of the affected pages.

6 files changed, 44 insertions, 48 deletions

diff --git a/docs/autoconf.rst b/docs/autoconf.rst
index 007252feb0..25ba71cf66 100644
--- a/docs/autoconf.rst
+++ b/docs/autoconf.rst
@@ -102,6 +102,7 @@ There are also a few general options for altering the Mesa build:
     This option ensures that assembly will not be used.
 
 ``--build=``
+    .. See host
 ``--host=``
     By default, the build will compile code for the architecture that
     it's running on. In order to build cross-compile Mesa on a x86-64
diff --git a/docs/dispatch.rst b/docs/dispatch.rst
index d6f8542c68..aba7192c31 100644
--- a/docs/dispatch.rst
+++ b/docs/dispatch.rst
@@ -62,18 +62,17 @@ conceptually simple:
 This can be implemented in just a few lines of C code. The file
 ``src/mesa/glapi/glapitemp.h`` contains code very similar to this.
 
-    +--------------------------------------------------------------------------+
-    | ::                                                                       |
-    |                                                                          |
-    |     void glVertex3f(GLfloat x, GLfloat y, GLfloat z)                     |
-    |     {                                                                    |
-    |         const struct _glapi_table * const dispatch = GET_DISPATCH();     |
-    |                                                                          |
-    |         (*dispatch->Vertex3f)(x, y, z);                                  |
-    |     }                                                                    |
-    +--------------------------------------------------------------------------+
-    | Sample dispatch function                                                 |
-    +--------------------------------------------------------------------------+
+Sample dispatch function
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: c
+
+     void glVertex3f(GLfloat x, GLfloat y, GLfloat z)
+     {
+         const struct _glapi_table * const dispatch = GET_DISPATCH();
+
+         (*dispatch->Vertex3f)(x, y, z);
+     }
 
 The problem with this simple implementation is the large amount of
 overhead that it adds to every GL function call.
@@ -118,16 +117,14 @@ resulting implementation of ``GET_DISPATCH`` is slightly more complex,
 but it avoids the expensive ``pthread_getspecific`` call in the common
 case.
 
-    +--------------------------------------------------------------------------+
-    | ::                                                                       |
-    |                                                                          |
-    |     #define GET_DISPATCH() \                                             |
-    |         (_glapi_Dispatch != NULL) \                                      |
-    |             ? _glapi_Dispatch : pthread_getspecific(&_glapi_Dispatch_key |
-    | )                                                                        |
-    +--------------------------------------------------------------------------+
-    | Improved ``GET_DISPATCH`` Implementation                                 |
-    +--------------------------------------------------------------------------+
+Improved ``GET_DISPATCH`` Implementation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. code-block:: c
+
+    #define GET_DISPATCH() \
+        (_glapi_Dispatch != NULL) \
+            ? _glapi_Dispatch : pthread_getspecific(&_glapi_Dispatch_key)
+
 
 3.2. ELF TLS
 ~~~~~~~~~~~~
@@ -145,16 +142,14 @@ with direct rendering drivers that use either interface. Once the
 pointer is properly declared, ``GET_DISPACH`` becomes a simple variable
 reference.
 
-    +--------------------------------------------------------------------------+
-    | ::                                                                       |
-    |                                                                          |
-    |     extern __thread struct _glapi_table *_glapi_tls_Dispatch             |
-    |         __attribute__((tls_model("initial-exec")));                      |
-    |                                                                          |
-    |     #define GET_DISPATCH() _glapi_tls_Dispatch                           |
-    +--------------------------------------------------------------------------+
-    | TLS ``GET_DISPATCH`` Implementation                                      |
-    +--------------------------------------------------------------------------+
+TLS ``GET_DISPATCH`` Implementation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. code-block:: c
+
+   extern __thread struct _glapi_table *_glapi_tls_Dispatch
+       __attribute__((tls_model("initial-exec")));
+
+   #define GET_DISPATCH() _glapi_tls_Dispatch
 
 Use of this path is controlled by the preprocessor define
 ``GLX_USE_TLS``. Any platform capable of using TLS should use this as
@@ -203,13 +198,12 @@ the assembly source file different implementations of the macro are
 selected based on the defined preprocessor variables. The assembly code
 then consists of a series of invocations of the macros such as:
 
-    +--------------------------------------------------------------------------+
-    | ::                                                                       |
-    |                                                                          |
-    |     GL_STUB(Color3fv, _gloffset_Color3fv)                                |
-    +--------------------------------------------------------------------------+
-    | SPARC Assembly Implementation of ``glColor3fv``                          |
-    +--------------------------------------------------------------------------+
+SPARC Assembly Implementation of ``glColor3fv``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: c
+
+    GL_STUB(Color3fv, _gloffset_Color3fv)
 
 The benefit of this technique is that changes to the calling pattern
 (i.e., addition of a new dispatch table pointer access method) require
diff --git a/docs/egl.rst b/docs/egl.rst
index bdd9290280..58caf945e9 100644
--- a/docs/egl.rst
+++ b/docs/egl.rst
@@ -64,6 +64,8 @@ time
     right platforms automatically.
 
 ``--enable-gles1``
+   .. See --enable-gles2
+
 ``--enable-gles2``
     These options enable OpenGL ES support in OpenGL. The result is one
     big internal library that supports multiple APIs.
diff --git a/docs/releasing.rst b/docs/releasing.rst
index 46aefc5849..aa3dec0e8f 100644
--- a/docs/releasing.rst
+++ b/docs/releasing.rst
@@ -342,13 +342,13 @@ Making a new release
 These are the instructions for making a new Mesa release.
 
 Get latest source files
-~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------
 
 Ensure the latest code is available - both in your local master and the
 relevant branch.
 
 Perform basic testing
-~~~~~~~~~~~~~~~~~~~~~
+---------------------
 
 Most of the testing should already be done during the
 `cherry-pick <#pickntest>`__ and `pre-announce <#prerelease>`__ stages.
@@ -444,13 +444,13 @@ Here is one solution that I've been using.
         unset VK_ICD_FILENAMES
 
 Update version in file VERSION
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+------------------------------
 
 Increment the version contained in the file VERSION at Mesa's top-level,
 then commit this change.
 
 Create release notes for the new release
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+----------------------------------------
 
 Create a new file docs/relnotes/X.Y.Z.html, (follow the style of the
 previous release notes). Note that the sha256sums section of the release
@@ -476,7 +476,7 @@ Commit these changes and push the branch.
        git push origin HEAD
 
 Use the release.sh script from xorg `util-modular <https://cgit.freedesktop.org/xorg/util/modular/>`__
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+------------------------------------------------------------------------------------------------------
 
 Start the release process.
 
@@ -491,13 +491,13 @@ your GPG and SSH passphrase(s) to sign and upload the files,
 respectively.
 
 Add the sha256sums to the release notes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+---------------------------------------
 
 Edit docs/relnotes/X.Y.Z.html to add the sha256sums as available in the
 mesa-X.Y.Z.announce template. Commit this change.
 
 Back on mesa master, add the new release notes into the tree
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+------------------------------------------------------------
 
 Something like the following steps will do the trick:
 
diff --git a/docs/relnotes/17.0.5.rst b/docs/relnotes/17.0.5.rst
index fc42af13ce..cc8202d882 100644
--- a/docs/relnotes/17.0.5.rst
+++ b/docs/relnotes/17.0.5.rst
@@ -64,7 +64,7 @@ Emil Velikov (5):
 
 -  docs: add sha256 checksums for 17.0.4
 -  winsys/sw/dri: don't use GNU void pointer arithmetic
--  st/clover: add space between < and ::
+-  st/clover: add space between < and :\:
 -  configure.ac: check require\_basic\_egl only if egl enabled
 -  st/mesa: automake: honour the vdpau header install location
 
diff --git a/docs/relnotes/9.2.2.rst b/docs/relnotes/9.2.2.rst
index 79216b7e61..49a181d9fc 100644
--- a/docs/relnotes/9.2.2.rst
+++ b/docs/relnotes/9.2.2.rst
@@ -14,7 +14,6 @@ because GL\_ARB\_compatibility is not supported.
 MD5 checksums
 -------------
 
-::
 
 New features
 ------------