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.
