docs: use inline-code instead of default role

A single backtick escaped string in Sphinx refers to the "default role"
which is vague, and in practice ends up producing the HTML cite-element.
That's almost certainly not what these uses wanted.

A bunch of these would probably be better served using appropriate roles
instead of inline-code markup, but this is almost certainly what was
meant here instead. Let's not let perfect be the enemy of good here, and
just do what was intended. Using the right roles everywhere is a big
task.

I usually don't do changes like these to the relnotes, but in this case
there were a *single* article that had these mistakes. I assume that was
an early bug in the script that generateg the relnotes. Let's patch it,
so we don't get misrendering if we change the default-role.

Reviewed-by: Yonggang Luo <luoyonggang@gmail.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19494>
This commit is contained in:
Erik Faye-Lund
2022-11-02 20:50:58 +01:00
committed by Marge Bot
parent 779b4639b7
commit 5525d0b196
21 changed files with 131 additions and 131 deletions

View File

@@ -82,10 +82,10 @@ The structure of any given tiling format is represented by ISL using the
.. doxygenstruct:: isl_tile_info
:members:
The `isl_tile_info` structure has two different sizes for a tile: a logical
The ``isl_tile_info`` structure has two different sizes for a tile: a logical
size in surface elements and a physical size in bytes. In order to determine
the proper logical size, the bits-per-block of the underlying format has to be
passed into `isl_tiling_get_info`. The proper way to compute the size of an
passed into ``isl_tiling_get_info``. The proper way to compute the size of an
image in bytes given a width and height in elements is as follows:
.. code-block:: c