libnm: add code comment about preserving ABI for libnm GObject structs

(cherry picked from commit f3abf2491a)

src/libnm-core-impl/nm-setting-8021x.c

@@ -187,11 +187,11 @@ typedef struct {
  */
 struct _NMSetting8021x {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSetting8021xClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-adsl.c

@@ -47,11 +47,11 @@ typedef struct {
  */
 struct _NMSettingAdsl {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingAdslClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-bluetooth.c

@@ -43,11 +43,11 @@ typedef struct {
  */
 struct _NMSettingBluetooth {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingBluetoothClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-bond.c

@@ -45,11 +45,11 @@ typedef struct {
  */
 struct _NMSettingBond {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingBondClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-bridge-port.c

@@ -46,11 +46,11 @@ typedef struct {
  */
 struct _NMSettingBridgePort {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingBridgePortClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-cdma.c

@@ -43,11 +43,11 @@ typedef struct {
  */
 struct _NMSettingCdma {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingCdmaClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-connection.c

@@ -104,11 +104,11 @@ typedef struct {
  */
 struct _NMSettingConnection {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingConnectionClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-dcb.c

@@ -72,11 +72,11 @@ typedef struct {
  */
 struct _NMSettingDcb {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingDcbClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-dummy.c

@@ -28,11 +28,11 @@
  */
 struct _NMSettingDummy {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingDummyClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-generic.c

@@ -34,11 +34,11 @@ typedef struct {
  */
 struct _NMSettingGeneric {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingGenericClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-gsm.c

@@ -62,11 +62,11 @@ typedef struct {
  */
 struct _NMSettingGsm {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingGsmClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-infiniband.c

@@ -47,11 +47,11 @@ typedef struct {
  */
 struct _NMSettingInfiniband {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingInfinibandClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-ip-tunnel.c

@@ -54,11 +54,11 @@ typedef struct {
  */
 struct _NMSettingIPTunnel {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingIPTunnelClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-ip4-config.c

@@ -52,11 +52,11 @@ typedef struct {
  */
 struct _NMSettingIP4Config {
     NMSettingIPConfig parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingIP4ConfigClass {
     NMSettingIPConfigClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-ip6-config.c

@@ -59,11 +59,11 @@ typedef struct {
  */
 struct _NMSettingIP6Config {
     NMSettingIPConfig parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingIP6ConfigClass {
     NMSettingIPConfigClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-macsec.c

@@ -56,11 +56,11 @@ typedef struct {
  */
 struct _NMSettingMacsec {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingMacsecClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-macvlan.c

@@ -41,11 +41,11 @@ typedef struct {
  */
 struct _NMSettingMacvlan {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingMacvlanClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-olpc-mesh.c

@@ -40,11 +40,11 @@ typedef struct {
  */
 struct _NMSettingOlpcMesh {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingOlpcMeshClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-ppp.c

@@ -69,11 +69,11 @@ typedef struct {
  */
 struct _NMSettingPpp {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingPppClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-pppoe.c

@@ -44,11 +44,11 @@ typedef struct {
  */
 struct _NMSettingPppoe {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingPppoeClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-private.h

@@ -27,12 +27,14 @@
  */
 struct _NMSetting {
     GObject parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingClass {
     GObjectClass parent;
 
-    /* Virtual functions */
+    /* In the past, this struct was public API. Preserve ABI! */
+
     int (*verify)(NMSetting *setting, NMConnection *connection, GError **error);
 
     gboolean (*verify_secrets)(NMSetting *setting, NMConnection *connection, GError **error);
@@ -51,7 +53,6 @@ struct _NMSettingClass {
                                  NMSettingSecretFlags flags,
                                  GError **            error);
 
-    /* In the past, this struct was public API. Preserve ABI! */
     gboolean (*clear_secrets)(const struct _NMSettInfoSetting *sett_info,
                               guint                            property_idx,
                               NMSetting *                      setting,
@@ -64,7 +65,6 @@ struct _NMSettingClass {
      *
      * @other may be %NULL, in which case the function only determines whether
      * the setting should be compared (TRUE) or not (DEFAULT). */
-    /* In the past, this struct was public API. Preserve ABI! */
     NMTernary (*compare_property)(const struct _NMSettInfoSetting *sett_info,
                                   guint                            property_idx,
                                   NMConnection *                   con_a,
@@ -73,21 +73,17 @@ struct _NMSettingClass {
                                   NMSetting *                      set_b,
                                   NMSettingCompareFlags            flags);
 
-    /* In the past, this struct was public API. Preserve ABI! */
     void (*duplicate_copy_properties)(const struct _NMSettInfoSetting *sett_info,
                                       NMSetting *                      src,
                                       NMSetting *                      dst);
 
-    /* In the past, this struct was public API. Preserve ABI! */
     void (*enumerate_values)(const struct _NMSettInfoProperty *property_info,
                              NMSetting *                       setting,
                              NMSettingValueIterFn              func,
                              gpointer                          user_data);
 
-    /* In the past, this struct was public API. Preserve ABI! */
     gboolean (*aggregate)(NMSetting *setting, int type_i, gpointer arg);
 
-    /* In the past, this struct was public API. Preserve ABI! */
     void (*for_each_secret)(NMSetting *                    setting,
                             const char *                   secret_name,
                             GVariant *                     val,
@@ -96,7 +92,6 @@ struct _NMSettingClass {
                             gpointer                       callback_data,
                             GVariantBuilder *              setting_builder);
 
-    /* In the past, this struct was public API. Preserve ABI! */
     gboolean (*init_from_dbus)(NMSetting *                     setting,
                                GHashTable *                    keys,
                                GVariant *                      setting_dict,
@@ -104,10 +99,8 @@ struct _NMSettingClass {
                                guint /* NMSettingParseFlags */ parse_flags,
                                GError **                       error);
 
-    /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[1];
 
-    /* In the past, this struct was public API. Preserve ABI! */
     const struct _NMMetaSettingInfo *setting_info;
 };
 

src/libnm-core-impl/nm-setting-serial.c

@@ -43,11 +43,11 @@ typedef struct {
  */
 struct _NMSettingSerial {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingSerialClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-team-port.c

@@ -42,11 +42,11 @@ typedef struct {
  */
 struct _NMSettingTeamPort {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingTeamPortClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-team.c

@@ -742,11 +742,11 @@ typedef struct {
  */
 struct _NMSettingTeam {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingTeamClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-tun.c

@@ -47,11 +47,11 @@ typedef struct {
  */
 struct _NMSettingTun {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingTunClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-vlan.c

@@ -48,11 +48,11 @@ typedef struct {
  */
 struct _NMSettingVlan {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingVlanClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-vpn.c

@@ -81,11 +81,11 @@ typedef struct {
  */
 struct _NMSettingVpn {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingVpnClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-vxlan.c

@@ -67,11 +67,11 @@ typedef struct {
  */
 struct _NMSettingVxlan {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingVxlanClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-wimax.c

@@ -42,11 +42,11 @@ typedef struct {
  */
 struct _NMSettingWimax {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingWimaxClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-wired.c

@@ -76,11 +76,11 @@ typedef struct {
  */
 struct _NMSettingWired {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingWiredClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-wireless-security.c

@@ -91,11 +91,11 @@ typedef struct {
  */
 struct _NMSettingWirelessSecurity {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingWirelessSecurityClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-setting-wireless.c

@@ -73,11 +73,11 @@ typedef struct {
  */
 struct _NMSettingWireless {
     NMSetting parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSettingWirelessClass {
     NMSettingClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };

src/libnm-core-impl/nm-simple-connection.c

@@ -25,11 +25,11 @@
  */
 struct _NMSimpleConnection {
     GObject parent;
+    /* In the past, this struct was public API. Preserve ABI! */
 };
 
 struct _NMSimpleConnectionClass {
     GObjectClass parent;
-
     /* In the past, this struct was public API. Preserve ABI! */
     gpointer padding[4];
 };