[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for eac
From: |
Peter Maydell |
Subject: |
Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want |
Date: |
Thu, 7 Mar 2019 13:30:39 +0000 |
On Thu, 7 Mar 2019 at 13:18, Cleber Rosa <address@hidden> wrote:
>
> On Thu, Mar 07, 2019 at 12:29:08PM +0000, Peter Maydell wrote:
> > I'm still not clear how this helps. Either the top level
> > index file has everything in it (in which case it's no good
> > for 'make install'), or we just have separate manuals per
>
> IIRC, it shouldn't matter what the "top level" index file (index.rst)
> has, because it's the resulting build (not the source index.rst) that
> will be 'make install'ed. Or am I missing something?
I guess what I'm trying to ask is whether this tags
approach results in different (or differently structured)
final documents being produced, or whether it's just a
different mechanism that gives the same end result.
> I don't see the multiple listings you mention here
I think I was looking at the sketch you had in a previous
email rather than the more fleshed-out code in the git repo.
> Anyway, if it's not clear to you as it's to me, then I'm probably
> biased or missing something.
Well, I'm also a bit biased here, in that this is v3 of this
patchset that's been on the list using this approach for
a month, and I was planning to apply it to master today
so that it could be in before the softfreeze on Tuesday
next week. So late-breaking suggestions for significant
restructurings are essentially saying "we should postpone
this to 4.1" :-(
thanks
-- PMM
- [Qemu-devel] [PATCH v3 10/12] Makefile: Abstract out "identify the pkgversion" code, (continued)
- [Qemu-devel] [PATCH v3 10/12] Makefile: Abstract out "identify the pkgversion" code, Peter Maydell, 2019/03/05
- [Qemu-devel] [PATCH v3 09/12] Makefile, configure: Support building rST documentation, Peter Maydell, 2019/03/05
- [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want, Peter Maydell, 2019/03/05
- Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want, Cleber Rosa, 2019/03/06
- Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want, Peter Maydell, 2019/03/07
- Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want, Cleber Rosa, 2019/03/07
- Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want, Peter Maydell, 2019/03/07
- Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want, Cleber Rosa, 2019/03/07
- Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want,
Peter Maydell <=
- Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want, Cleber Rosa, 2019/03/07
- Re: [Qemu-devel] [PATCH v3 08/12] docs: Provide separate conf.py for each manual we want, Peter Maydell, 2019/03/07
[Qemu-devel] [PATCH v3 11/12] docs/conf.py: Don't hard-code QEMU version, Peter Maydell, 2019/03/05
[Qemu-devel] [PATCH v3 12/12] MAINTAINERS: Add entry for Sphinx documentation infrastructure, Peter Maydell, 2019/03/05
Re: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs, no-reply, 2019/03/05
Re: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs, no-reply, 2019/03/05
Re: [Qemu-devel] [PATCH v3 00/12] Enable build and install of our rST docs, no-reply, 2019/03/05