[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v3 2/2] docs/sphinx: change default role to "any"
From: |
Eduardo Habkost |
Subject: |
Re: [PATCH v3 2/2] docs/sphinx: change default role to "any" |
Date: |
Thu, 23 Sep 2021 16:38:24 -0400 |
On Thu, Sep 23, 2021 at 03:13:23PM -0400, John Snow wrote:
> This interprets single-backtick syntax in all of our Sphinx docs as a
> cross-reference to *something*, including Python symbols.
>
> From here on out, new uses of `backticks` will cause a build failure if
> the target cannot be referenced.
>
> Signed-off-by: John Snow <jsnow@redhat.com>
Patch 1/2 demonstrates why patch 2/2 is useful.
Reviewed-by: Eduardo Habkost <ehabkost@redhat.com>
> ---
> docs/conf.py | 5 +++++
> 1 file changed, 5 insertions(+)
>
> diff --git a/docs/conf.py b/docs/conf.py
> index ff6e92c6e2e..4d9f56601fc 100644
> --- a/docs/conf.py
> +++ b/docs/conf.py
> @@ -85,6 +85,11 @@
> # The master toctree document.
> master_doc = 'index'
>
> +# Interpret `single-backticks` to be a cross-reference to any kind of
> +# referenceable object. Unresolvable or ambiguous references will emit a
> +# warning at build time.
> +default_role = 'any'
> +
> # General information about the project.
> project = u'QEMU'
> copyright = u'2021, The QEMU Project Developers'
> --
> 2.31.1
>
--
Eduardo