Re: [PATCH v4 04/46] qapi: modify docstrings to be sphinx-compatible

[John Snow]

On 9/30/20 4:47 AM, Markus Armbruster wrote:
> Sadly, the fact that start_if() and end_if() are functions isn't
> immediately obvious anymore.
>
> I've seen :func:`start_if` elsewhere.  Is this something we should or
> want to use?

Looks like `start_if()` works just fine too. If you are hard-set in 
wanting to see those parentheses I can use this style, but admit I am 
not likely to use them myself in newer docstrings, and there's no way to 
enforce their presence OR absence that I am aware of.

I'll bake that change in for now until I see another reply.

--js