On Tue, 25 Feb 2020 at 17:48, Paolo Bonzini <pbonz...@redhat.com> wrote: > > On 25/02/20 18:11, Peter Maydell wrote: > >> I assume these are not meant to be applied now, except patch 2? > > No, I intended them to be reviewable and applied now. Why > > do you think we should wait? > > Because they remove information from qemu-doc.texi. I think it's > feasible to do a mass conversion quite soon, within a single pull > request, the only important part that is missing is the hxtool conversion.
My assumption was that we would attack this by: * converting chunks of the documentation which are in qemu-doc.texi but which aren't in the qemu.1 manpage (basically in the way this series is doing) * get the qapidoc generation conversion reviewed and into master (since at the moment it outputs into files included from qemu-doc) * convert the manpage parts; we have the machinery for dealing with the hxtool files, it just needs a little more work > (See also the patches I posted today, which take the opposite direction > of making qemu-doc.texi's structure more like what we'll have in the end > in docs/system). This ought to make it easier to do the conversion of the various subparts, right? Incidentally: > makeinfo -o - --docbook security.texi | pandoc -f docbook -t rst security texi was the really easy one here. I had to do more manual formatting fixups on qemu-deprecated.texi which I'm sceptical would have worked out as nicely done automatically. The automatic conversion rune also doesn't seem to get quotes and apostrophes right: it has turned "guest B's disk image" into something with a smartquote character in it, for instance. thanks -- PMM
