As promised, here's a pull request with the patches which do the qemu-doc rST conversion.
Minor changes since the patchset was posted: * rebased * the two auto-generated patches have been regenerated, to account for the qemu-options.hx changes that went into master since the patchset was posted I have also now done the testing of the OSX change to the docs link. We've agreed to leave updating the Windows installer for later. thanks -- PMM The following changes since commit 6b02fca71329ed858423b710699952b7f017034e: Merge remote-tracking branch 'remotes/palmer/tags/riscv-for-master-5.0-sf4' into staging (2020-03-05 20:53:53 +0000) are available in the Git repository at: https://git.linaro.org/people/pmaydell/qemu-arm.git tags/pull-docs-20200306 for you to fetch changes up to 29f9dff79073cfdc336466a950294be91b90f514: *.hx: Remove all the STEXI/ETEXI blocks (2020-03-06 11:06:55 +0000) ---------------------------------------------------------------- docs: * Convert qemu-doc from Texinfo to rST ---------------------------------------------------------------- Kashyap Chamarthy (1): docs/system: Convert qemu-cpu-models.texi to rST Paolo Bonzini (13): qemu-doc: convert user-mode emulation to a separate Sphinx manual qemu-doc: remove target OS documentation texi2pod: parse @include directives outside "@c man" blocks qemu-doc: split CPU models doc between MIPS and x86 parts qemu-doc: split qemu-doc.texi in multiple files qemu-doc: extract common system emulator documentation from the PC section qemu-doc: move system requirements chapter inside PC section qemu-doc: split target sections to separate files qemu-doc: move qemu-tech.texi into main section qemu-doc: move included files to docs/system qemu-doc: remove indices other than findex docs/system: put qemu-block-drivers body in an included file docs/system: convert Texinfo documentation to rST Peter Maydell (19): qemu-doc: Remove the "CPU emulation" part of the "Implementation notes" docs: Create defs.rst.inc as a place to define substitutions docs/system: Convert security.texi to rST format docs/system: convert managed startup to rST. docs/system: convert the documentation of deprecated features to rST. hmp-commands.hx: Add rST documentation fragments hmp-commands-info.hx: Add rST documentation fragments doc/scripts/hxtool.py: Strip trailing ':' from DEFHEADING/ARCHHEADING docs: Roll semihosting option information into qemu-options.hx docs: Roll -prom-env and -g target-specific info into qemu-options.hx scripts/hxtool-conv: Archive script used in qemu-options.hx conversion qemu-options.hx: Add rST documentation fragments qemu-options.hx: Fix up the autogenerated rST docs: Split out sections for the manpage into .rst.inc files docs: Generate qemu.1 manpage with Sphinx ui/cocoa.m: Update documentation file and pathname docs: Stop building qemu-doc docs: Remove old texinfo sources *.hx: Remove all the STEXI/ETEXI blocks docs/specs/ivshmem-spec.txt | 4 +- Makefile | 47 +- .gitignore | 3 - MAINTAINERS | 7 +- docs/conf.py | 6 + docs/defs.rst.inc | 15 + docs/index.html.in | 2 +- docs/index.rst | 1 + docs/qemu-cpu-models.texi | 677 --- docs/sphinx/hxtool.py | 10 +- docs/system/build-platforms.rst | 79 + docs/system/conf.py | 8 +- docs/system/cpu-models-mips.rst.inc | 105 + docs/system/cpu-models-x86.rst.inc | 365 ++ docs/system/deprecated.rst | 446 ++ docs/system/device-url-syntax.rst.inc | 228 + docs/system/gdb.rst | 81 + docs/system/images.rst | 85 + docs/system/index.rst | 22 +- docs/system/invocation.rst | 18 + docs/system/ivshmem.rst | 64 + docs/system/keys.rst | 6 + docs/system/keys.rst.inc | 35 + docs/system/license.rst | 11 + docs/system/linuxboot.rst | 30 + docs/system/managed-startup.rst | 35 + docs/system/monitor.rst | 31 + docs/system/mux-chardev.rst | 6 + docs/system/mux-chardev.rst.inc | 27 + docs/system/net.rst | 100 + docs/system/qemu-block-drivers.rst | 989 +--- docs/system/qemu-block-drivers.rst.inc | 954 ++++ docs/system/qemu-cpu-models.rst | 20 + docs/system/qemu-manpage.rst | 45 + docs/system/quickstart.rst | 13 + docs/{security.texi => system/security.rst} | 82 +- docs/system/target-arm.rst | 217 + docs/system/target-i386-desc.rst.inc | 62 + docs/system/target-i386.rst | 23 + docs/system/target-m68k.rst | 21 + docs/system/target-mips.rst | 120 + docs/system/target-ppc.rst | 47 + docs/system/target-sparc.rst | 62 + docs/system/target-sparc64.rst | 37 + docs/system/target-xtensa.rst | 27 + docs/system/targets.rst | 19 + docs/system/tls.rst | 328 ++ docs/system/usb.rst | 137 + docs/system/vnc-security.rst | 202 + docs/user/conf.py | 15 + docs/user/index.rst | 16 + docs/user/main.rst | 295 ++ hmp-commands-info.hx | 600 +-- hmp-commands.hx | 1451 +++--- qemu-deprecated.texi | 377 -- qemu-doc.texi | 2967 ----------- qemu-option-trace.texi | 28 - qemu-options.hx | 7333 ++++++++++++++------------- qemu-tech.texi | 195 - scripts/hxtool-conv.pl | 137 + scripts/texi2pod.pl | 36 +- ui/cocoa.m | 4 +- 62 files changed, 9302 insertions(+), 10111 deletions(-) create mode 100644 docs/defs.rst.inc delete mode 100644 docs/qemu-cpu-models.texi create mode 100644 docs/system/build-platforms.rst create mode 100644 docs/system/cpu-models-mips.rst.inc create mode 100644 docs/system/cpu-models-x86.rst.inc create mode 100644 docs/system/deprecated.rst create mode 100644 docs/system/device-url-syntax.rst.inc create mode 100644 docs/system/gdb.rst create mode 100644 docs/system/images.rst create mode 100644 docs/system/invocation.rst create mode 100644 docs/system/ivshmem.rst create mode 100644 docs/system/keys.rst create mode 100644 docs/system/keys.rst.inc create mode 100644 docs/system/license.rst create mode 100644 docs/system/linuxboot.rst create mode 100644 docs/system/managed-startup.rst create mode 100644 docs/system/monitor.rst create mode 100644 docs/system/mux-chardev.rst create mode 100644 docs/system/mux-chardev.rst.inc create mode 100644 docs/system/net.rst create mode 100644 docs/system/qemu-block-drivers.rst.inc create mode 100644 docs/system/qemu-cpu-models.rst create mode 100644 docs/system/qemu-manpage.rst create mode 100644 docs/system/quickstart.rst rename docs/{security.texi => system/security.rst} (77%) create mode 100644 docs/system/target-arm.rst create mode 100644 docs/system/target-i386-desc.rst.inc create mode 100644 docs/system/target-i386.rst create mode 100644 docs/system/target-m68k.rst create mode 100644 docs/system/target-mips.rst create mode 100644 docs/system/target-ppc.rst create mode 100644 docs/system/target-sparc.rst create mode 100644 docs/system/target-sparc64.rst create mode 100644 docs/system/target-xtensa.rst create mode 100644 docs/system/targets.rst create mode 100644 docs/system/tls.rst create mode 100644 docs/system/usb.rst create mode 100644 docs/system/vnc-security.rst create mode 100644 docs/user/conf.py create mode 100644 docs/user/index.rst create mode 100644 docs/user/main.rst delete mode 100644 qemu-deprecated.texi delete mode 100644 qemu-doc.texi delete mode 100644 qemu-option-trace.texi delete mode 100644 qemu-tech.texi create mode 100755 scripts/hxtool-conv.pl
