[PATCH v4 00/19] Add 'version' to other exported types

Andrea Bolognani abologna at redhat.com
Tue Apr 26 16:06:08 UTC 2022


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



More information about the libvir-list mailing list