On Fri, 11 Oct 2024 at 10:50, Paolo Bonzini <pbonz...@redhat.com> wrote:
>
> All footnotes must come after a separator in reStructuredText.  Fix the
> two files in which this does not happen.  This mistake is caught by
> Sphinx 8.1.0 as an unreferenced footnote.

Worth noting in the commit message that this isn't just new
Sphinx being picky about syntax -- the current docs actually
misrender the intended footnote link literally:

...from the venv itself[#distlib]_. If no...

It's a shame that the way the footnote syntax is defined
means that you have to remember this awkward "\ " in the
really common case of "footnote marker at end of word or
sentence, and that the rST documentation's examples of
footnote syntax contain only artificial examples and none
where you need this.

Reviewed-by: Peter Maydell <peter.mayd...@linaro.org>

thanks
-- PMM

Reply via email to