Re: [Qemu-devel] Exploring Sphinx, autodoc, apidoc, and coverage tools for python/qemu

[Peter Maydell]

On Wed, 24 Jul 2019 at 22:06, John Snow <address@hidden> wrote:
> And then you can edit e.g. the top-level index.rst TOC in docs/index.rst
> to look like this:
>
> ```
> .. toctree::
>    :maxdepth: 2
>    :caption: Contents:
>
>    interop/index
>    devel/index
>    specs/index
>    modules
> ```

This is obviously just prototyping, but you don't want to put
anything new in this top level index.rst -- it's only used
for by-hand full-tree docs builds. Builds from the makefile
rules will just build our separate manuals (interop, devel,
specs) separately. You want to put your new documentation into
whichever manual is best suited (probably devel/, but possibly
interop/ in some cases?)

(Will read the rest of this email later.)

thanks
-- PMM