[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v5 00/20] Convert QAPI doc comments to generate rST instead o
From: |
Markus Armbruster |
Subject: |
Re: [PATCH v5 00/20] Convert QAPI doc comments to generate rST instead of texinfo |
Date: |
Thu, 24 Sep 2020 16:49:38 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) |
Peter Maydell <peter.maydell@linaro.org> writes:
> On Fri, 4 Sep 2020 at 17:05, Peter Maydell <peter.maydell@linaro.org> wrote:
>> On Fri, 4 Sep 2020 at 16:54, Markus Armbruster <armbru@redhat.com> wrote:
>> > visit_module() lets you see the modules.
>> >
>> > visit_include() lets you see the includes. The same module can be
>> > included multiple times. Having to filter that out would be annoying.
>>
>> I don't think you'd need to filter it out for this use case -- I
>> assume Sphinx would just ignore the unnecessary extra dependency
>> information. But if visit_module() does what we want and you
>> recommend it I'll look at that.
>
> visit_module() seems to work. I notice it gets called with None
> before it's called with the filename of the top level qapi-schema.json,
> but it's easy enough to ignore the 'None' call...
None stands for the (nameless) module containing built-in stuff.