https://qemu.readthedocs.io/en/latest/index.html collects various documents from the QEMU docs/ subdirectory; however, none of the s390 files are currently included. Therefore, I set out to convert the existing files to rst and hook them up.
s390-dasd-ipl was straightforward enough; I also found a numbering issue. vfio-ap was quite a bit more involved, but I hope I have produced something readable (more review can never hurt...) I also moved this into the system/ subdirectory; not sure if that is the best resting place, but it seemed to be the most reasonable one. Tested via running 'make html' and inspecting the output. Branch: https://github.com/cohuck/qemu rstfy-s390-v2 Changes v1->v2 (mostly addressing feedback from Peter; thanks!): - dasd ipl: fix some indentation - vfio-ap: autogenerate contents table - vfio-ap: use more literals - vfio-ap: convert some examples to tables - vfio-ap: various other formatting cleanups Cornelia Huck (2): docs: rstfy s390 dasd ipl documentation docs: rstfy vfio-ap documentation MAINTAINERS | 4 +- docs/devel/index.rst | 1 + .../{s390-dasd-ipl.txt => s390-dasd-ipl.rst} | 119 +-- docs/system/index.rst | 1 + docs/{vfio-ap.txt => system/vfio-ap.rst} | 796 +++++++++--------- 5 files changed, 484 insertions(+), 437 deletions(-) rename docs/devel/{s390-dasd-ipl.txt => s390-dasd-ipl.rst} (51%) rename docs/{vfio-ap.txt => system/vfio-ap.rst} (55%) base-commit: 81f49abaaac2b88062bd1b07f451d9527ed1c9ce -- 2.21.1