On 21/05/19 11:42, Peter Maydell wrote: > (The other interesting thing I'd wondered about with generation > of docs from code comments is whether we would get better > (ie more accurate, regularly updated) documentation of our > supported machine models if we generated those parts of the > docs from comments. But that's definitely much harder than just > getting API documentation, because it involves trying to > integrate them into a 'user documentation' manual which we > have not yet converted from texinfo.)
For the user documentation, makeinfo can produce docbook, and that seems to be the best way to convert out of Texinfo. At that point you can either pass docbook to sphinx (see https://wiki.qemu.org/Features/Documentation though it's a bit out of date), or convert it to rST using Pandoc. Paolo
