> > >> By running sphinx over the docs/ directory (like readthedocs.org > > >> presumably does), it finds a couple of rst documents that are not > > >> referenced: > > >> - cpu-hotplug.rst > > >> - microvm.rst > > >> - pr-manager.rst > > >> - virtio-net-failover.rst > > > > Given the current structure of the content in > > https://qemu.readthedocs.io/en/latest/, > > would adding this as a new bullet in "QEMU System Emulation User’s > > Guide" be the right thing to do? > > Adding which? > > For cpu-hotplug.rst: > I guess the system manual. The document has a bit of a > "tutorial" feel which doesn't entirely fit the rest of the > manuals. > > For microvm.rst: > docs/system/target-i386.rst should be split into > documentation for each of the machine models separately > (as a list of links to docs in docs/system/i386/, similar > to the structure of target-arm.rst and docs/system/arm/). > Then microvm.rst can go into docs/system/i386. > > For pr-manager.rst: > The parts that are documenting the qemu-pr-helper invocation > should turn into a docs/tools/ manpage for it. > The other parts should go in the system manual I guess. > > For virtio-net-failover.rst: > Should go under the "Network emulation" part of the system > manual, I think.
Maybe existing memory emulation 'txt' files need to be converted into '.rst', and along with virtio-pmem.rst could be moved to a new section? Thanks, Pankaj
