docs: use inline-code instead of default role
authorErik Faye-Lund <erik.faye-lund@collabora.com>
Wed, 2 Nov 2022 19:50:58 +0000 (20:50 +0100)
committerMarge Bot <emma+marge@anholt.net>
Fri, 4 Nov 2022 16:38:06 +0000 (16:38 +0000)
commit5525d0b196b555fea933ab8f65fe3dba18006624
treed5c5015198293e94828b62cbf199991c716dbdfd
parent779b4639b75b60b9201278b0873b80b04dbaa50c
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>
21 files changed:
docs/ci/bare-metal.rst
docs/ci/index.rst
docs/ci/kernel.rst
docs/ci/local-traces.rst
docs/ci/skqp.rst
docs/dispatch.rst
docs/drivers/asahi.rst
docs/drivers/freedreno/ir3-notes.rst
docs/drivers/llvmpipe.rst
docs/drivers/panfrost.rst
docs/drivers/vc4.rst
docs/envvars.rst
docs/gallium/cso/blend.rst
docs/gallium/screen.rst
docs/gallium/tgsi.rst
docs/isl/tiling.rst
docs/macos.rst
docs/relnotes/20.2.0.rst
docs/vulkan/base-objs.rst
docs/vulkan/dispatch.rst
docs/vulkan/graphics-state.rst