John Snow <js...@redhat.com> writes:

> On Fri, Mar 7, 2025 at 7:34 AM Markus Armbruster <arm...@redhat.com> wrote:
>
>> John Snow <js...@redhat.com> writes:
>>
>> > Add debugging output for the qapidoc transmogrifier - setting DEBUG=1
>> > will produce .ir files (one for each qapidoc directive) that write the
>> > generated rst file to disk to allow for easy debugging and verification
>> > of the generated document.
>> >
>> > Signed-off-by: John Snow <js...@redhat.com>
>>
>> I understand we generally need to examine these .ir files only when
>> things go wrong, or maybe to help understanding the transmogrifier.  I
>> guess few people will care, and only rarely.  But when we care, we
>> likely care a *lot*.  Sure we want to dig the information on how to get
>> .ir files out of a commit message then?
>>
>
> Intend to advertise it in the transmogrifier doc and/or extend the
> doc-writing section of the qapi code gen doc.

Okay!


Reply via email to