Message ID | 20200225140437.20609-1-peter.maydell@linaro.org (mailing list archive) |
---|---|
Headers | show |
Series | Convert QAPI doc comments to generate rST instead of texinfo | expand |
Peter Maydell <peter.maydell@linaro.org> writes: > This series switches all our QAPI doc comments over from > texinfo format to rST. > > I've pushed out a v3 because a lot of v2 is now in master and > it seems like it might be easier (and less intimidating :-)) > to review a patchset that's only got the remaining work and > which is based on current master. Appreciated! > Changes v2->v3: > * all the "preliminary tidy up of existing doc comment" patches > are now in master -- thanks! > * rebased on current master (there were some minor conflicts with > the just-committed creation of the tools manual) > > We have 3 weeks left til softfreeze, so I'm still hopeful we > can land this in this release cycle, though I suppose it would > not be a disaster if it landed in the next. (I'm guessing we > will not complete conversion of the other bits of Texinfo to > rST this cycle, anyway.) I'll try to review in time. Plenty of competition, so no promises. [...]
On Tue, 25 Feb 2020 at 14:04, Peter Maydell <peter.maydell@linaro.org> wrote: > > This series switches all our QAPI doc comments over from > texinfo format to rST. > Git branch of this series also available at > https://git.linaro.org/people/peter.maydell/qemu-arm.git sphinx-conversions I've just updated this git branch with a rebase on top of: * current master, which has the qemu-doc conversion * the minor-cleanups patchset I just posted No serious changes to the meat of the series: * some new text in migration.json needed indenting to match this series' stricter requirements * fixups of (textual) makefile conflicts * five new patches at the end which delete all the texinfo machinery since once the qapi generation is converted we don't need texinfo at all I'll probably send a new set of patches to the list next week; this set should still be fine for review though. thanks -- PMM