On Mon, May 4, 2026 at 7:20 AM Markus Armbruster <[email protected]> wrote: > > I'm feeling dense again. Please be patient with me. > > John Snow <[email protected]> writes: > > > A forthcoming patch removes the implicit PLAIN section that always > > starts a QAPIDoc section list. Further future changes begin converting > > "PLAIN" sections to "INTRO" sections. To accommodate this, the insertion > > algorithm that places stub and dummy members must be adjusted to cope. > > What are the stub and dummy members? > > > This algorithm can handle zero-or-more PLAIN *or* INTRO sections at the > > beginning of a QAPIDoc object. > > The revised algorithm, I presume. > > What's the structure of its valid input before and after this patch?
Addendum thought: this algorithm is more complex/flexible than it needs to be with regards to what possible inputs may be, but this is to allow it to cope with a changing parser during the gradual conversion. Take heart: the .ir outputs do not change at all with this algorithm change, so you can feel assured that it Does The Right Thing, even if it looks hideous. --js
