On Mon, 2023-11-06 at 14:35 +0000, David Woodhouse wrote: > From: David Woodhouse <dwmw@xxxxxxxxxxxx> > > We can't just embed labels directly into files like qemu-options.hx which > are included from multiple top-level RST files, because Sphinx sees the > labels as duplicate: https://github.com/sphinx-doc/sphinx/issues/9707 > > So add an 'emitrefs' option to the Sphinx hxtool-doc directive, which is > set only in invocation.rst and not from the HTML rendition of the man > page. Along with an argument to the SRST directive which causes a label > of the form '.. _LABEL-reference-label:' to be emitted when the emitrefs > option is set. > > Signed-off-by: David Woodhouse <dwmw@xxxxxxxxxxxx> > --- FWIW I've left this out of the pull request I just sent, and the Xen docs just tell the user to go *find* the -initrd documentation instead of being able to emit a direct link. We can fix that later.
Attachment:
smime.p7s
Description: S/MIME cryptographic signature
