Hi,
Here it comes, version 3.
v1:
https://listman.redhat.com/archives/libvir-list/2022-April/229881.html
v2:
https://listman.redhat.com/archives/libvir-list/2022-April/230097.html
In this version, I have:
- dropped the changes to .sym files (Peter, Daniel)
- improved commit log: 'doc' -> 'docstring' (and more) (Peter)
- fixed all versions prior to v1.0.0 (Peter, Andrea)
- created a validate script, to confirm all is good. Not expecting it
to be merged, just added to help review that the outcome is
acceptable.
- lots of fixes found by the script above.
- dropped the concept of generated/manual in git shortlog of the series.
- added an allow list for functions where there is a mismatch between
version in the sym file and the git tag they were introduced (Peter)
I hope that it'll be useful to other generators, besides:
https://gitlab.com/libvirt/libvirt-go-module/-/merge_requests/7
Gitlab run of this series (fails with codestyle of do-not-commit
script).
https://gitlab.com/victortoso/libvirt/-/pipelines/520901763
Have a wonderful day,
Victor
Victor Toso (30):
syntax-check: sc_prohibit_nonreentrant: skip comments
syntax-check: prohibit_virXXXFree: skip strings
docstring: Fix generated documentation of
virConnectListAllNodeDeviceFlags
docstring: variable: Move docstring from source to header file
docstring: enums: libvirt: Add 'Since version' metadata
docstring: enums: qemu: Add 'Since version' metadata
docstring: enums: admin: Add 'Since version' metadata
docstring: macros: libvirt: Add 'Since version' metadata
docstring: macros: admin: Add 'Since version' metadata
docstring: typedef: libvirt:: Add 'Since version' metadata
docstring: typedef: qemu:: Add 'Since version' metadata
docstring: typedef: admin:: Add 'Since version' metadata
docstring: function: libvirt: Add 'Since version' metadata
docstring: function: qemu: Add 'Since version' metadata
docstring: function: lxc: Add 'Since version' metadata
docstring: function: admin: Add 'Since version' metadata
docstring: libvirt-common: Add 'Since version' metadata
docstring: Fix generated documentation of virStorageVolInfoFlags
docstring: Fix and append Since to virConnectListAllStoragePoolsFlags
docstring: Fix and append Since to virDomainDeviceModifyFlags
docstring: Fix and append Since to virDomainMemoryModFlags
docstring: Fix and append Since to virDomainVcpuFlags
scripts: apibuild: parse 'Since' version for enums
scripts: apibuild: fix parsing block comments from typedef enum
scripts: apibuild: parse 'Since' for typedefs
scripts: apibuild: parse 'Since' for macros
scripts: apibuild: parse 'Since' for functions
scripts: apibuild: factor out comment cleaning
scripts: apibuild: add parsing variable's comments
do-not-commit: script to validate output
build-aux/syntax-check.mk | 4 +-
include/libvirt/libvirt-admin.h | 95 +-
include/libvirt/libvirt-common.h.in | 54 +-
include/libvirt/libvirt-domain-checkpoint.h | 62 +-
include/libvirt/libvirt-domain-snapshot.h | 100 +-
include/libvirt/libvirt-domain.h | 2665 +++++++++++++++----
include/libvirt/libvirt-event.h | 35 +-
include/libvirt/libvirt-host.h | 320 ++-
include/libvirt/libvirt-interface.h | 33 +-
include/libvirt/libvirt-network.h | 195 +-
include/libvirt/libvirt-nodedev.h | 100 +-
include/libvirt/libvirt-nwfilter.h | 29 +-
include/libvirt/libvirt-qemu.h | 39 +-
include/libvirt/libvirt-secret.h | 81 +-
include/libvirt/libvirt-storage.h | 316 ++-
include/libvirt/libvirt-stream.h | 48 +-
include/libvirt/virterror.h | 428 +--
scripts/apibuild.py | 212 +-
scripts/version-quest.py | 190 ++
src/admin/libvirt-admin.c | 93 +
src/libvirt-domain-checkpoint.c | 36 +
src/libvirt-domain-snapshot.c | 63 +
src/libvirt-domain.c | 557 +++-
src/libvirt-host.c | 102 +
src/libvirt-interface.c | 63 +
src/libvirt-lxc.c | 12 +
src/libvirt-network.c | 135 +
src/libvirt-nodedev.c | 81 +
src/libvirt-nwfilter.c | 72 +
src/libvirt-qemu.c | 18 +
src/libvirt-secret.c | 60 +
src/libvirt-storage.c | 171 ++
src/libvirt-stream.c | 51 +
src/libvirt.c | 29 +-
src/util/virerror.c | 45 +
src/util/virevent.c | 27 +
src/util/virtypedparam-public.c | 57 +
37 files changed, 5533 insertions(+), 1145 deletions(-)
create mode 100644 scripts/version-quest.py
--
2.35.1