Failure building NM docs
gtk-doc 1.31 fails to build NetworkManager 1.20.0's docs.
Commenting out the raise
enabled by 58094106 works around the problem.
Meson log excerpt
Building documentation for libnm
/build/networkmanager/src/NetworkManager/libnm-core/./nm-vpn-plugin-info.h:0: warning: partial declaration (struct) : typedef struct {
NM_AVAILABLE_IN_1_2
GObjectClass parent;
/*< private >*/
NM_AVAILABLE_IN_1_2
gpointer padding[8];
} NMVpnPluginInfoClass NM_AVAILABLE_IN_1_2;
NM_AVAILABLE_IN_1_2
GType nm_vpn_plugin_info_get_type (void);
NM_AVAILABLE_IN_1_2
NMVpnPluginInfo *nm_vpn_plugin_info_new_from_file (const char *filename,
GError **error);
NM_AVAILABLE_IN_1_2
NMVpnPluginInfo *nm_vpn_plugin_info_new_with_data (const char *filename,
GKeyFile *keyfile,
GError **error);
NM_AVAILABLE_IN_1_4
NMVpnPluginInfo *nm_vpn_plugin_info_new_search_file (const char *name,
const char *service);
NM_AVAILABLE_IN_1_2
const char *nm_vpn_plugin_info_get_name (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_2
const char *nm_vpn_plugin_info_get_filename (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_4
const char *nm_vpn_plugin_info_get_service (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_2
const char *nm_vpn_plugin_info_get_plugin (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_2
const char *nm_vpn_plugin_info_get_program (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_4
const char *nm_vpn_plugin_info_get_auth_dialog (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_4
gboolean nm_vpn_plugin_info_supports_hints (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_2
gboolean nm_vpn_plugin_info_supports_multiple (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_4
const char *const*nm_vpn_plugin_info_get_aliases (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_2
const char *nm_vpn_plugin_info_lookup_property (NMVpnPluginInfo *self, const char *group, const char *key);
NM_AVAILABLE_IN_1_2
gboolean nm_vpn_plugin_info_validate_filename (const char *filename);
NM_AVAILABLE_IN_1_2
GSList *nm_vpn_plugin_info_list_load (void);
NM_AVAILABLE_IN_1_2
gboolean nm_vpn_plugin_info_list_add (GSList **list, NMVpnPluginInfo *plugin_info, GError **error);
NM_AVAILABLE_IN_1_2
gboolean nm_vpn_plugin_info_list_remove (GSList **list, NMVpnPluginInfo *plugin_info);
NM_AVAILABLE_IN_1_2
NMVpnPluginInfo *nm_vpn_plugin_info_list_find_by_name (GSList *list, const char *name);
NM_AVAILABLE_IN_1_2
NMVpnPluginInfo *nm_vpn_plugin_info_list_find_by_filename (GSList *list, const char *filename);
NM_AVAILABLE_IN_1_2
NMVpnPluginInfo *nm_vpn_plugin_info_list_find_by_service (GSList *list, const char *service);
NM_AVAILABLE_IN_1_4
char *nm_vpn_plugin_info_list_find_service_type (GSList *list, const char *name);
NM_AVAILABLE_IN_1_4
char **nm_vpn_plugin_info_list_get_service_types (GSList *list,
gboolean only_existing,
gboolean with_abbreviations);
NM_AVAILABLE_IN_1_2
NMVpnEditorPlugin *nm_vpn_plugin_info_get_editor_plugin (NMVpnPluginInfo *self);
NM_AVAILABLE_IN_1_2
void nm_vpn_plugin_info_set_editor_plugin (NMVpnPluginInfo *self,
NMVpnEditorPlugin *plugin);
NM_AVAILABLE_IN_1_2
NMVpnEditorPlugin *nm_vpn_plugin_info_load_editor_plugin (NMVpnPluginInfo *self,
GError **error);
G_END_DECLS
#endif /* __NM_VPN_PLUGIN_INFO_H__ */
/build/networkmanager/src/NetworkManager/libnm/./nm-vpn-plugin-old.h:0: warning: partial declaration (struct) : typedef struct {
NM_DEPRECATED_IN_1_2
GObject parent;
} NMVpnPluginOld NM_DEPRECATED_IN_1_2;
typedef struct {
NM_DEPRECATED_IN_1_2
GObjectClass parent;
/* Signals */
NM_DEPRECATED_IN_1_2
void (*state_changed) (NMVpnPluginOld *plugin,
NMVpnServiceState state);
NM_DEPRECATED_IN_1_2
void (*ip4_config) (NMVpnPluginOld *plugin,
GVariant *ip4_config);
NM_DEPRECATED_IN_1_2
void (*login_banner) (NMVpnPluginOld *plugin,
const char *banner);
NM_DEPRECATED_IN_1_2
void (*failure) (NMVpnPluginOld *plugin,
NMVpnPluginFailure reason);
NM_DEPRECATED_IN_1_2
void (*quit) (NMVpnPluginOld *plugin);
NM_DEPRECATED_IN_1_2
void (*config) (NMVpnPluginOld *plugin,
GVariant *config);
NM_DEPRECATED_IN_1_2
void (*ip6_config) (NMVpnPluginOld *plugin,
GVariant *config);
/* virtual methods */
NM_DEPRECATED_IN_1_2
gboolean (*connect) (NMVpnPluginOld *plugin,
NMConnection *connection,
GError **err);
NM_DEPRECATED_IN_1_2
gboolean (*need_secrets) (NMVpnPluginOld *plugin,
NMConnection *connection,
const char **setting_name,
GError **error);
NM_DEPRECATED_IN_1_2
gboolean (*disconnect) (NMVpnPluginOld *plugin,
GError **err);
NM_DEPRECATED_IN_1_2
gboolean (*new_secrets) (NMVpnPluginOld *plugin,
NMConnection *connection,
GError **error);
NM_DEPRECATED_IN_1_2
gboolean (*connect_interactive) (NMVpnPluginOld *plugin,
NMConnection *connection,
GVariant *details,
GError **error);
/*< private >*/
NM_DEPRECATED_IN_1_2
gpointer padding[8];
} NMVpnPluginOldClass NM_DEPRECATED_IN_1_2;
NM_DEPRECATED_IN_1_2
GType nm_vpn_plugin_old_get_type (void);
NM_DEPRECATED_IN_1_2
GDBusConnection *nm_vpn_plugin_old_get_connection (NMVpnPluginOld *plugin);
NM_DEPRECATED_IN_1_2
NMVpnServiceState nm_vpn_plugin_old_get_state (NMVpnPluginOld *plugin);
NM_DEPRECATED_IN_1_2
void nm_vpn_plugin_old_set_state (NMVpnPluginOld *plugin,
NMVpnServiceState state);
NM_DEPRECATED_IN_1_2
void nm_vpn_plugin_old_secrets_required (NMVpnPluginOld *plugin,
const char *message,
const char **hints);
NM_DEPRECATED_IN_1_2
void nm_vpn_plugin_old_set_login_banner (NMVpnPluginOld *plugin,
const char *banner);
NM_DEPRECATED_IN_1_2
void nm_vpn_plugin_old_failure (NMVpnPluginOld *plugin,
NMVpnPluginFailure reason);
NM_DEPRECATED_IN_1_2
void nm_vpn_plugin_old_set_config (NMVpnPluginOld *plugin,
GVariant *config);
NM_DEPRECATED_IN_1_2
void nm_vpn_plugin_old_set_ip4_config (NMVpnPluginOld *plugin,
GVariant *ip4_config);
NM_DEPRECATED_IN_1_2
void nm_vpn_plugin_old_set_ip6_config (NMVpnPluginOld *plugin,
GVariant *ip6_config);
NM_DEPRECATED_IN_1_2
gboolean nm_vpn_plugin_old_disconnect (NMVpnPluginOld *plugin,
GError **err);
/* Utility functions */
NM_DEPRECATED_IN_1_2
gboolean nm_vpn_plugin_old_read_vpn_details (int fd,
GHashTable **out_data,
GHashTable **out_secrets);
NM_DEPRECATED_IN_1_2
gboolean nm_vpn_plugin_old_get_secret_flags (GHashTable *data,
const char *secret_name,
NMSettingSecretFlags *out_flags);
G_END_DECLS
#endif /* __NM_VPN_PLUGIN_OLD_H__ */
/build/networkmanager/src/NetworkManager/libnm/./nm-vpn-service-plugin.h:0: warning: partial declaration (struct) : typedef struct {
NM_AVAILABLE_IN_1_2
GObject parent;
} NMVpnServicePlugin NM_AVAILABLE_IN_1_2;
typedef struct {
NM_AVAILABLE_IN_1_2
GObjectClass parent;
/* Signals */
NM_AVAILABLE_IN_1_2
void (*state_changed) (NMVpnServicePlugin *plugin,
NMVpnServiceState state);
NM_AVAILABLE_IN_1_2
void (*ip4_config) (NMVpnServicePlugin *plugin,
GVariant *ip4_config);
NM_AVAILABLE_IN_1_2
void (*login_banner) (NMVpnServicePlugin *plugin,
const char *banner);
NM_AVAILABLE_IN_1_2
void (*failure) (NMVpnServicePlugin *plugin,
NMVpnPluginFailure reason);
NM_AVAILABLE_IN_1_2
void (*quit) (NMVpnServicePlugin *plugin);
NM_AVAILABLE_IN_1_2
void (*config) (NMVpnServicePlugin *plugin,
GVariant *config);
NM_AVAILABLE_IN_1_2
void (*ip6_config) (NMVpnServicePlugin *plugin,
GVariant *config);
/* virtual methods */
NM_AVAILABLE_IN_1_2
gboolean (*connect) (NMVpnServicePlugin *plugin,
NMConnection *connection,
GError **err);
NM_AVAILABLE_IN_1_2
gboolean (*need_secrets) (NMVpnServicePlugin *plugin,
NMConnection *connection,
const char **setting_name,
GError **error);
NM_AVAILABLE_IN_1_2
gboolean (*disconnect) (NMVpnServicePlugin *plugin,
GError **err);
NM_AVAILABLE_IN_1_2
gboolean (*new_secrets) (NMVpnServicePlugin *plugin,
NMConnection *connection,
GError **error);
NM_AVAILABLE_IN_1_2
gboolean (*connect_interactive) (NMVpnServicePlugin *plugin,
NMConnection *connection,
GVariant *details,
GError **error);
/*< private >*/
NM_AVAILABLE_IN_1_2
gpointer padding[8];
} NMVpnServicePluginClass NM_AVAILABLE_IN_1_2;
NM_AVAILABLE_IN_1_2
GType nm_vpn_service_plugin_get_type (void);
NM_AVAILABLE_IN_1_2
GDBusConnection *nm_vpn_service_plugin_get_connection (NMVpnServicePlugin *plugin);
NM_AVAILABLE_IN_1_2
void nm_vpn_service_plugin_secrets_required (NMVpnServicePlugin *plugin,
const char *message,
const char **hints);
NM_AVAILABLE_IN_1_2
void nm_vpn_service_plugin_set_login_banner (NMVpnServicePlugin *plugin,
const char *banner);
NM_AVAILABLE_IN_1_2
void nm_vpn_service_plugin_failure (NMVpnServicePlugin *plugin,
NMVpnPluginFailure reason);
NM_AVAILABLE_IN_1_2
void nm_vpn_service_plugin_set_config (NMVpnServicePlugin *plugin,
GVariant *config);
NM_AVAILABLE_IN_1_2
void nm_vpn_service_plugin_set_ip4_config (NMVpnServicePlugin *plugin,
GVariant *ip4_config);
NM_AVAILABLE_IN_1_2
void nm_vpn_service_plugin_set_ip6_config (NMVpnServicePlugin *plugin,
GVariant *ip6_config);
NM_AVAILABLE_IN_1_2
gboolean nm_vpn_service_plugin_disconnect (NMVpnServicePlugin *plugin,
GError **err);
NM_AVAILABLE_IN_1_12
void nm_vpn_service_plugin_shutdown (NMVpnServicePlugin *plugin);
/* Utility functions */
NM_AVAILABLE_IN_1_2
gboolean nm_vpn_service_plugin_read_vpn_details (int fd,
GHashTable **out_data,
GHashTable **out_secrets);
NM_AVAILABLE_IN_1_2
gboolean nm_vpn_service_plugin_get_secret_flags (GHashTable *data,
const char *secret_name,
NMSettingSecretFlags *out_flags);
G_END_DECLS
#endif /* __NM_VPN_SERVICE_PLUGIN_H__ */
./libnm-decl.txt:10898: warning: NMTeamLinkWatcher has multiple definitions.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-bond.c:968: warning: Symbol name not found at the start of the comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-ethtool.c:40: warning: multi-line since docs found
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-vpn.c:1080: warning: Symbol name not found at the start of the comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-vpn.c:1106: warning: Symbol name not found at the start of the comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-wired.c:1585: warning: Symbol name not found at the start of the comment block.
/build/networkmanager/src/NetworkManager/libnm/./nm-dhcp-config.c:155: warning: Symbol name not found at the start of the comment block.
/build/networkmanager/src/NetworkManager/libnm/./nm-secret-agent-old.c:867: warning: Symbol name not found at the start of the comment block.
/build/networkmanager/src/NetworkManager/libnm/./nm-secret-agent-old.c:910: warning: Symbol name not found at the start of the comment block.
/build/networkmanager/src/NetworkManager/libnm/./nm-secret-agent-old.c:937: warning: Symbol name not found at the start of the comment block.
unknown:0: warning: Value descriptions for NMIPTunnelFlags are missing in source code comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-macvlan.h:62: warning: Value description for NMSettingMacvlanMode::_NM_SETTING_MACVLAN_MODE_NUM is missing in source code comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-macvlan.h:62: warning: Value description for NMSettingMacvlanMode::NM_SETTING_MACVLAN_MODE_LAST is missing in source code comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-match.c:180: warning: Parameter description for nm_setting_match_get_interface_names::length is missing in source code comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-wireless.h:43: warning: Value description for NMSettingWirelessWakeOnWLan::NM_SETTING_WIRELESS_WAKE_ON_WLAN_TCP is missing in source code comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-wireless.h:135: warning: Value description for NMSettingWirelessPowersave::_NM_SETTING_WIRELESS_POWERSAVE_NUM is missing in source code comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-wireless.h:135: warning: Value description for NMSettingWirelessPowersave::NM_SETTING_WIRELESS_POWERSAVE_LAST is missing in source code comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-wireless-security.h:73: warning: Value description for NMSettingWirelessSecurityPmf::_NM_SETTING_WIRELESS_SECURITY_PMF_NUM is missing in source code comment block.
/build/networkmanager/src/NetworkManager/libnm-core/./nm-setting-wireless-security.h:73: warning: Value description for NMSettingWirelessSecurityPmf::NM_SETTING_WIRELESS_SECURITY_PMF_LAST is missing in source code comment block.
unknown:0: warning: Value descriptions for NMTeamAttribute are missing in source code comment block.
unknown:0: warning: Field descriptions for struct NMTeamSettingData are missing in source code comment block.
unknown:0: warning: Field descriptions for struct NMTeamSetting are missing in source code comment block.
2019-08-06 11:30:07,250:common.py:ParseStructDeclaration:352:WARNING:Cannot parse struct field: "GObject parent"
./libnm-unused.txt:1: warning: 41 unused declarations. They should be added to libnm-sections.txt in the appropriate place.
ERROR: Error in gtkdoc helper script:
ERROR: ['gtkdoc-mkhtml', '--path=/build/networkmanager/src/NetworkManager/docs/libnm:/build/networkmanager/src/build/docs/libnm', 'libnm', '../libnm-docs.xml'] failed with status 6
warning: failed to load external entity "../xml/nm-vpn-service-plugin.xml"
../libnm-docs.xml:295: element include: XInclude error : could not load ../xml/nm-vpn-service-plugin.xml, and no fallback was found
warning: failed to load external entity "../xml/nm-vpn-plugin-info.xml"
../libnm-docs.xml:296: element include: XInclude error : could not load ../xml/nm-vpn-plugin-info.xml, and no fallback was found
warning: failed to load external entity "../xml/nm-vpn-plugin-old.xml"
../libnm-docs.xml:299: element include: XInclude error : could not load ../xml/nm-vpn-plugin-old.xml, and no fallback was found