On Fri, Apr 22, 2022 at 09:23:25PM +0200, Victor Toso wrote: > - For exported version of functions, the syms file are the source of > truth apart from 4 functions (Peter) > https://listman.redhat.com/archives/libvir-list/2022-April/230236.html > > - Variable's comments are now properly sanitized (Andrea) > https://listman.redhat.com/archives/libvir-list/2022-April/230352.html > > - Removed an extra line in the block of comments (Andrea) > https://listman.redhat.com/archives/libvir-list/2022-April/230291.html Pushed the remaining patches as well. Thanks a lot for tackling this! Ideas for follow-up work: * improve the generator so that multi-line comments attached to enum values and macros get all newlines stripped before ending up in the XML. Right now it's done very inconsistently; * include version information in the HTML documentation; * whatever can be done to make apibuild.py at least somewhat sane :) One more thing. Right now version tags look like Since: v1.2.3 but the "v" part doesn't really need to be there IMO, and in fact it has to be stripped when generating the XML. How would you feel about not having it in the documentation in the first place? -- Andrea Bolognani / Red Hat / Virtualization
