David Woodhouse 1eeb432a95 doc/sphinx/hxtool.py: add optional label argument to SRST directive ... 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 optional argument to the SRST directive which causes a label of the form '.. _DOCNAME-HXFILE-LABEL:' to be emitted, where 'DOCNAME' is the name of the top level rST file, 'HXFILE' is the filename of the .hx file, and 'LABEL' is the text provided within the 'SRST()' directive. Using the DOCNAME of the top-level rST document means that it is unique even when the .hx file is included from two different documents, as is the case for qemu-options.hx Now where the Xen PV documentation refers to the documentation for the -initrd command line option, it can emit a link directly to it as '<system/invocation-qemu-options-initrd>'. Signed-off-by: David Woodhouse <dwmw@amazon.co.uk> Reviewed-by: Paul Durrant <paul@xen.org> Reviewed-by: Peter Maydell <peter.maydell@linaro.org> Message-id: 20240130190348.682912-1-dwmw2@infradead.org Signed-off-by: Peter Maydell <peter.maydell@linaro.org>		2024-02-02 13:51:58 +00:00
..
migration	docs/migration: Further move virtio to be feature of migration	2024-01-16 11:16:10 +08:00
acpi-bits.rst	Revert "tests: Use separate virtual environment for avocado"	2023-08-28 09:55:48 +02:00
atomics.rst	atomics: eliminate mb_read/mb_set	2023-06-06 09:42:14 +02:00
bitops.rst	docs: Create bitops.rst as example of kernel-docs	2019-12-17 19:36:57 +01:00
blkdebug.txt	docs/: fix some comment spelling errors	2020-09-17 20:37:13 +02:00
blkverify.txt	meson: link emulators without Makefile.target	2020-08-21 06:30:40 -04:00
block-coroutine-wrapper.rst	block-coroutine-wrapper.py: introduce co_wrapper	2022-12-15 16:07:43 +01:00
build-system.rst	meson: remove CONFIG_ALL	2023-12-31 09:11:28 +01:00
ci-definitions.rst.inc	tests/acceptance: rename tests acceptance to tests avocado	2021-11-08 17:00:22 +01:00
ci-jobs.rst.inc	gitlab: enable ccache for many build jobs	2023-08-30 14:57:33 +01:00
ci-runners.rst.inc	docs: name included files ".rst.inc"	2021-10-01 19:04:45 +02:00
ci.rst	docs/devel: clean-up the CI links in the docs	2022-06-01 18:55:04 +01:00
clocks.rst	docs: Constify VMstate in examples	2023-12-30 07:38:06 +11:00
code-of-conduct.rst	docs/devel: add a maintainers section to development process	2022-11-22 09:49:07 +00:00
conflict-resolution.rst	docs: Add a QEMU Code of Conduct and Conflict Resolution Policy document	2021-04-01 13:21:02 +02:00
control-flow-integrity.rst	Fix typo in CFI build documentation	2021-05-02 17:24:50 +02:00
decodetree.rst	docs: Document decodetree named field syntax	2023-05-30 10:55:39 -07:00
docs.rst	doc/sphinx/hxtool.py: add optional label argument to SRST directive	2024-02-02 13:51:58 +00:00
ebpf_rss.rst	docs/devel/ebpf_rss.rst: Format literals correctly	2021-08-02 11:42:38 +01:00
fuzzing.rst	docs/fuzz: remove mentions of fork-based fuzzing	2023-02-16 23:02:46 -05:00
index-api.rst	hw/pci: modify pci_setup_iommu() to set PCIIOMMUOps	2023-11-03 09:20:31 +01:00
index-build.rst	docs/devel/docs: Document .hx file syntax	2024-01-15 17:12:22 +00:00
index-internals.rst	docs/migration: Create index page	2024-01-16 11:16:10 +08:00
index-process.rst	docs/devel: add some front matter to the devel index	2023-07-03 12:52:08 +01:00
index-tcg.rst	docs/devel: add some front matter to the devel index	2023-07-03 12:52:08 +01:00
index.rst	docs/devel: add some front matter to the devel index	2023-07-03 12:52:08 +01:00
kconfig.rst	configure, meson: rename targetos to host_os	2023-12-31 09:11:29 +01:00
loads-stores.rst	docs/devel/loads-stores: Fix git grep regexes	2023-09-21 14:45:57 +01:00
lockcnt.txt	docs: fix references to docs/devel/atomics.rst	2021-06-02 06:51:09 +02:00
maintainers.rst	docs/devel: add a maintainers section to development process	2022-11-22 09:49:07 +00:00
memory.rst	docs/devel: add some clarifying text for aliases	2022-01-18 12:56:29 +01:00
modules.rst	docs: Spell QEMU all caps	2021-11-19 10:16:58 +01:00
multi-process.rst	docs: Don't mention "-mem-path" in multi-process.rst	2023-09-19 10:23:21 +02:00
multi-thread-tcg.rst	Rename "QEMU global mutex" to "BQL" in comments and docs	2024-01-08 10:45:43 -05:00
multiple-iothreads.txt	Rename "QEMU global mutex" to "BQL" in comments and docs	2024-01-08 10:45:43 -05:00
pci.rst	hw/pci: modify pci_setup_iommu() to set PCIIOMMUOps	2023-11-03 09:20:31 +01:00
qapi-code-gen.rst	docs/devel/qapi-code-gen: Fix missing ':' in tagged section docs	2024-01-26 07:04:53 +01:00
qdev-api.rst	docs/devel: split qom-api reference into new file	2023-07-03 12:52:22 +01:00
qgraph.rst	Fix some typos in documentation (found by codespell)	2021-11-22 15:02:38 +01:00
qom-api.rst	docs/devel: split qom-api reference into new file	2023-07-03 12:52:22 +01:00
qom.rst	misc: Fix some typos in documentation and comments	2023-08-01 23:52:23 +02:00
qtest.rst	system: Rename softmmu/ directory as system/	2023-10-08 21:08:08 +02:00
rcu.txt	Docs/RCU: Correct sample code of qatomic_rcu_set	2021-01-12 12:38:03 +01:00
replay.rst	Rename "QEMU global mutex" to "BQL" in comments and docs	2024-01-08 10:45:43 -05:00
reset.rst	Replace "iothread lock" with "BQL" in comments	2024-01-08 10:45:43 -05:00
s390-cpu-topology.rst	docs/s390: Fix wrong command example in s390-cpu-topology.rst	2023-11-28 14:27:18 +01:00
s390-dasd-ipl.rst	docs: rstfy s390 dasd ipl documentation	2020-02-26 18:57:07 +01:00
secure-coding-practices.rst	docs/secure-coding-practices: Describe how to use 'null-co' block driver	2021-06-02 14:29:14 +02:00
stable-process.rst	docs: Fix botched rST conversion of 'submitting-a-patch.rst'	2021-11-22 15:02:38 +01:00
style.rst	docs/style: permit inline loop variables	2023-08-30 14:57:44 +01:00
submitting-a-patch.rst	docs/devel: try and improve the language around patch review	2022-11-22 09:52:23 +00:00
submitting-a-pull-request.rst	docs/devel: add a maintainers section to development process	2022-11-22 09:49:07 +00:00
tcg-icount.rst	accel/tcg: Remove CF_LAST_IO	2023-11-14 10:40:54 -08:00
tcg-ops.rst	docs/devel/tcg-ops: fix missing newlines in "Host vector operations"	2023-08-24 11:22:42 -07:00
tcg-plugins.rst	docs: add a new section to outline emulation support	2023-02-02 10:44:23 +00:00
tcg.rst	docs/devel: add some front matter to the devel index	2023-07-03 12:52:08 +01:00
testing.rst	gitlab: add optional job to run flaky avocado tests	2023-12-01 17:47:20 +00:00
tracing.rst	docs: trace-events-all is installed without renaming	2022-04-21 17:03:51 +04:00
trivial-patches.rst	docs: Fix botched rST conversion of 'submitting-a-patch.rst'	2021-11-22 15:02:38 +01:00
ui.rst	docs: Spell QEMU all caps	2021-11-19 10:16:58 +01:00
vfio-iommufd.rst	docs/devel: Add VFIO iommufd backend documentation	2023-12-19 19:03:38 +01:00
virtio-backends.rst	docs/devel: start documenting writing VirtIO devices	2022-05-16 04:38:40 -04:00
writing-monitor-commands.rst	qapi: Fix dangling references to docs/devel/qapi-code-gen.txt	2024-01-26 07:04:53 +01:00
zoned-storage.rst	docs/zoned-storage:add zoned emulation use case	2023-05-15 08:19:04 -04:00