libnm-util, libnm-glib: add versioned deprecation/availability macros
authorDan Winship <danw@gnome.org>
Wed, 12 Feb 2014 17:28:52 +0000 (12:28 -0500)
committerDan Winship <danw@gnome.org>
Thu, 13 Feb 2014 16:24:37 +0000 (11:24 -0500)
commit9c4d86ee8064fa36710b8d2d242d9618d4fc763a
tree810f8c7dffdfcfbd96289da821f31597bbfe8a3b
parent95be722e5411d26a0d631cb6dff1995b85c6940f
libnm-util, libnm-glib: add versioned deprecation/availability macros

Add versioned NM_DEPRECATED_IN_* and NM_AVAILABLE_IN_* macros, and tag
new/deprecated functions accordingly. (All currently-deprecated
functions are assumed to have been deprecated in 0.9.10.)

Add NM_VERSION_MIN_REQUIRED and NM_VERSION_MAX_ALLOWED macros which
can be set to determine which versions will cause warnings.

With the current settings, external consumers of the
libnm-util/libnm-glib APIs will have MIN_REQUIRED and MAX_ALLOWED both
set to NM_VERSION_0_9_8 by default, meaning they will get warnings
about functions added in 0.9.10. NM internally sets
NM_VERSION_MAX_ALLOWED to NM_VERSION_NEXT_STABLE to ensure that it is
always allowed to use all APIs.
50 files changed:
callouts/Makefile.am
cli/src/Makefile.am
docs/libnm-glib/Makefile.am
docs/libnm-util/Makefile.am
include/nm-version.h.in
libnm-glib/Makefile.am
libnm-glib/nm-access-point.h
libnm-glib/nm-active-connection.h
libnm-glib/nm-client.h
libnm-glib/nm-device-generic.h
libnm-glib/nm-device-team.h
libnm-glib/nm-device.h
libnm-glib/nm-ip4-config.h
libnm-glib/nm-ip6-config.h
libnm-glib/nm-object.h
libnm-glib/nm-remote-connection.h
libnm-glib/nm-remote-settings.h
libnm-glib/nm-secret-agent.h
libnm-glib/nm-vpn-plugin-ui-interface.h
libnm-glib/nm-vpn-plugin.h
libnm-util/Makefile.am
libnm-util/nm-connection.h
libnm-util/nm-setting-bond.h
libnm-util/nm-setting-connection.h
libnm-util/nm-setting-dcb.h
libnm-util/nm-setting-generic.h
libnm-util/nm-setting-gsm.h
libnm-util/nm-setting-team-port.h
libnm-util/nm-setting-team.h
libnm-util/nm-setting-wired.h
libnm-util/nm-setting-wireless.h
libnm-util/nm-setting.h
libnm-util/nm-utils.h
libnm-util/tests/Makefile.am
src/Makefile.am
src/platform/tests/Makefile.am
src/settings/plugins/example/Makefile.am
src/settings/plugins/ifcfg-rh/Makefile.am
src/settings/plugins/ifcfg-rh/tests/Makefile.am
src/settings/plugins/ifcfg-suse/Makefile.am
src/settings/plugins/ifnet/Makefile.am
src/settings/plugins/ifnet/tests/Makefile.am
src/settings/plugins/ifupdown/Makefile.am
src/settings/plugins/ifupdown/tests/Makefile.am
src/settings/plugins/keyfile/Makefile.am
src/settings/plugins/keyfile/tests/Makefile.am
src/tests/Makefile.am
test/Makefile.am
tools/Makefile.am
tui/Makefile.am