Re: [Qemu-devel] [PATCH v6 10/25] replay: introduce breakpoint at the specified step

[Peter Maydell]

On 25 September 2018 at 10:40, Paolo Bonzini <address@hidden> wrote:
> However, we currently have the worst of both worlds.  We have a manual
> in Texinfo that almost nobody updates (except for the small parts that
> are generated from .hx files in the code) and sparse documentation
> written in a mix of rST, Markdown-but-not-quite, and
> not-even-trying-to-be-Markdown.

One improvement I've thought about here would be having board
documentation (eg "what is this board, what devices does it
implement or not yet implement") be in a doc comment in the
relevant source file, and then we could stitch those together
into the user-facing docs. Right now the texinfo (as you say)
has a really outdated list of boards and info on them.

thanks
-- PMM