Re: [PATCH v3 05/47] qapi/doc.py: Change code templates from function to string

2020-09-29 Thread John Snow
On 9/28/20 11:51 PM, Cleber Rosa wrote: On Thu, Sep 24, 2020 at 08:28:18PM -0400, John Snow wrote: For whatever reason, when these are stored as functions instead of strings, it confuses sphinx-autodoc into believing them to be docstrings, and it chokes on the syntax. Interesting... Keeping

Re: [PATCH v3 05/47] qapi/doc.py: Change code templates from function to string

2020-09-28 Thread Cleber Rosa
On Thu, Sep 24, 2020 at 08:28:18PM -0400, John Snow wrote: > For whatever reason, when these are stored as functions instead of > strings, it confuses sphinx-autodoc into believing them to be > docstrings, and it chokes on the syntax. > Interesting... > Keeping them as dumb strings instead avoids

Re: [PATCH v3 05/47] qapi/doc.py: Change code templates from function to string

2020-09-25 Thread John Snow
On 9/25/20 4:59 AM, Markus Armbruster wrote: John Snow writes: For whatever reason, when these are stored as functions instead of strings, it confuses sphinx-autodoc into believing them to be docstrings, and it chokes on the syntax. Keeping them as dumb strings instead avoids the problem. Si

Re: [PATCH v3 05/47] qapi/doc.py: Change code templates from function to string

2020-09-25 Thread Markus Armbruster
John Snow writes: > For whatever reason, when these are stored as functions instead of > strings, it confuses sphinx-autodoc into believing them to be > docstrings, and it chokes on the syntax. > > Keeping them as dumb strings instead avoids the problem. > > Signed-off-by: John Snow Quoting my

[PATCH v3 05/47] qapi/doc.py: Change code templates from function to string

2020-09-24 Thread John Snow
For whatever reason, when these are stored as functions instead of strings, it confuses sphinx-autodoc into believing them to be docstrings, and it chokes on the syntax. Keeping them as dumb strings instead avoids the problem. Signed-off-by: John Snow --- scripts/qapi/doc.py | 40 ++