trivial: Get rid of useless internal-only gtk-doc markup

25 files changed, 0 insertions, 775 deletions

diff --git a/libappstream-glib/as-app-builder.c b/libappstream-glib/as-app-builder.c
index 12d8b0e..a63f9c1 100644
--- a/libappstream-glib/as-app-builder.c
+++ b/libappstream-glib/as-app-builder.c
@@ -50,9 +50,6 @@ typedef struct {
 	GPtrArray	*translations;		/* no ref */
 } AsAppBuilderContext;
 
-/**
- * as_app_builder_entry_new:
- **/
 static AsAppBuilderEntry *
 as_app_builder_entry_new (void)
 {
@@ -61,9 +58,6 @@ as_app_builder_entry_new (void)
 	return entry;
 }
 
-/**
- * as_app_builder_entry_free:
- **/
 static void
 as_app_builder_entry_free (AsAppBuilderEntry *entry)
 {
@@ -71,9 +65,6 @@ as_app_builder_entry_free (AsAppBuilderEntry *entry)
 	g_slice_free (AsAppBuilderEntry, entry);
 }
 
-/**
- * as_app_builder_ctx_new:
- **/
 static AsAppBuilderContext *
 as_app_builder_ctx_new (void)
 {
@@ -82,9 +73,6 @@ as_app_builder_ctx_new (void)
 	return ctx;
 }
 
-/**
- * as_app_builder_ctx_free:
- **/
 static void
 as_app_builder_ctx_free (AsAppBuilderContext *ctx)
 {
@@ -107,9 +95,6 @@ typedef struct {
 	guint32		 trans_sysdep_tab_offset;
 } AsAppBuilderGettextHeader;
 
-/**
- * as_app_builder_parse_file_gettext:
- **/
 static gboolean
 as_app_builder_parse_file_gettext (AsAppBuilderContext *ctx,
 				   const gchar *locale,
@@ -149,9 +134,6 @@ as_app_builder_parse_file_gettext (AsAppBuilderContext *ctx,
 	return TRUE;
 }
 
-/**
- * as_app_builder_search_locale_gettext:
- **/
 static gboolean
 as_app_builder_search_locale_gettext (AsAppBuilderContext *ctx,
 				      const gchar *locale,
@@ -256,9 +238,6 @@ _read_uint32 (const guint8 *data, guint32 *offset)
 	return GUINT32_FROM_BE (tmp);
 }
 
-/**
- * as_app_builder_parse_data_qt:
- **/
 static void
 as_app_builder_parse_data_qt (AsAppBuilderContext *ctx,
 			      const gchar *locale,
@@ -304,9 +283,6 @@ as_app_builder_parse_data_qt (AsAppBuilderContext *ctx,
 	ctx->data = g_list_prepend (ctx->data, entry);
 }
 
-/**
- * as_app_builder_parse_file_qt:
- **/
 static gboolean
 as_app_builder_parse_file_qt (AsAppBuilderContext *ctx,
 			      const gchar *locale,
@@ -352,9 +328,6 @@ as_app_builder_parse_file_qt (AsAppBuilderContext *ctx,
 	return TRUE;
 }
 
-/**
- * as_app_builder_search_translations_qt:
- **/
 static gboolean
 as_app_builder_search_translations_qt (AsAppBuilderContext *ctx,
 				       const gchar *prefix,
@@ -406,9 +379,6 @@ as_app_builder_search_translations_qt (AsAppBuilderContext *ctx,
 	return TRUE;
 }
 
-/**
- * as_app_builder_search_translations_gettext:
- **/
 static gboolean
 as_app_builder_search_translations_gettext (AsAppBuilderContext *ctx,
 					    const gchar *prefix,
@@ -436,9 +406,6 @@ as_app_builder_search_translations_gettext (AsAppBuilderContext *ctx,
 	return TRUE;
 }
 
-/**
- * as_app_builder_entry_sort_cb:
- **/
 static gint
 as_app_builder_entry_sort_cb (gconstpointer a, gconstpointer b)
 {
@@ -517,9 +484,6 @@ as_app_builder_search_translations (AsApp *app,
 	return TRUE;
 }
 
-/**
- * as_app_builder_search_path:
- **/
 static gboolean
 as_app_builder_search_path (AsApp *app,
 			    const gchar *prefix,
@@ -591,9 +555,6 @@ as_app_builder_search_kudos (AsApp *app,
 	return TRUE;
 }
 
-/**
- * as_app_builder_search_dbus_file:
- **/
 static gboolean
 as_app_builder_search_dbus_file (AsApp *app,
 				 const gchar *filename,
@@ -620,9 +581,6 @@ as_app_builder_search_dbus_file (AsApp *app,
 	return TRUE;
 }
 
-/**
- * as_app_builder_search_dbus:
- **/
 static gboolean
 as_app_builder_search_dbus (AsApp *app,
 			    const gchar *prefix,
diff --git a/libappstream-glib/as-app-desktop.c b/libappstream-glib/as-app-desktop.c
index 5527ba6..28605ca 100644
--- a/libappstream-glib/as-app-desktop.c
+++ b/libappstream-glib/as-app-desktop.c
@@ -25,9 +25,6 @@
 #include "as-app-private.h"
 #include "as-utils.h"
 
-/**
- * as_app_desktop_key_get_locale:
- */
 static gchar *
 as_app_desktop_key_get_locale (const gchar *key)
 {
@@ -46,9 +43,6 @@ as_app_desktop_key_get_locale (const gchar *key)
 	return locale;
 }
 
-/**
- * as_app_infer_file_key:
- **/
 static gboolean
 as_app_infer_file_key (AsApp *app,
 		       GKeyFile *kf,
@@ -96,9 +90,6 @@ as_app_infer_file_key (AsApp *app,
 	return TRUE;
 }
 
-/**
- * _as_utils_is_stock_icon_name_fallback:
- **/
 static gboolean
 _as_utils_is_stock_icon_name_fallback (const gchar *name)
 {
@@ -117,9 +108,6 @@ _as_utils_is_stock_icon_name_fallback (const gchar *name)
 	return FALSE;
 }
 
-/**
- * as_app_parse_file_key:
- **/
 static gboolean
 as_app_parse_file_key (AsApp *app,
 		       GKeyFile *kf,
@@ -366,9 +354,6 @@ as_app_parse_file_key (AsApp *app,
 	return TRUE;
 }
 
-/**
- * as_app_parse_file_key_fallback_comment:
- **/
 static gboolean
 as_app_parse_file_key_fallback_comment (AsApp *app,
 					GKeyFile *kf,
@@ -403,9 +388,6 @@ as_app_parse_file_key_fallback_comment (AsApp *app,
 	return TRUE;
 }
 
-/**
- * as_app_parse_desktop_file:
- **/
 gboolean
 as_app_parse_desktop_file (AsApp *app,
 			   const gchar *desktop_file,
diff --git a/libappstream-glib/as-app-inf.c b/libappstream-glib/as-app-inf.c
index 134a043..2169fb9 100644
--- a/libappstream-glib/as-app-inf.c
+++ b/libappstream-glib/as-app-inf.c
@@ -28,9 +28,6 @@
 
 #define AS_APP_INF_CLASS_GUID_FIRMWARE	"f2e7dd72-6468-4e36-b6f1-6488f42c1b52"
 
-/**
- * as_app_parse_inf_sanitize_guid:
- */
 static gchar *
 as_app_parse_inf_sanitize_guid (const gchar *guid)
 {
@@ -46,9 +43,6 @@ as_app_parse_inf_sanitize_guid (const gchar *guid)
 	return g_string_free (id, FALSE);
 }
 
-/**
- * as_app_parse_inf_file:
- **/
 gboolean
 as_app_parse_inf_file (AsApp *app,
 		       const gchar *filename,
diff --git a/libappstream-glib/as-app-validate.c b/libappstream-glib/as-app-validate.c
index 64f4735..d4fb408 100644
--- a/libappstream-glib/as-app-validate.c
+++ b/libappstream-glib/as-app-validate.c
@@ -42,9 +42,6 @@ typedef struct {
 	guint			 number_paragraphs;
 } AsAppValidateHelper;
 
-/**
- * ai_app_validate_add:
- */
 G_GNUC_PRINTF (3, 4) static void
 ai_app_validate_add (AsAppValidateHelper *helper,
 		     AsProblemKind kind,
@@ -104,9 +101,6 @@ ai_app_validate_fullstop_ending (const gchar *tmp)
 	return tmp[str_len - 1] == '.';
 }
 
-/**
- * as_app_validate_has_hyperlink:
- **/
 static gboolean
 as_app_validate_has_hyperlink (const gchar *text)
 {
@@ -119,9 +113,6 @@ as_app_validate_has_hyperlink (const gchar *text)
 	return FALSE;
 }
 
-/**
- * as_app_validate_has_email:
- **/
 static gboolean
 as_app_validate_has_email (const gchar *text)
 {
@@ -132,9 +123,6 @@ as_app_validate_has_email (const gchar *text)
 	return FALSE;
 }
 
-/**
- * as_app_validate_has_first_word_capital:
- **/
 static gboolean
 as_app_validate_has_first_word_capital (AsAppValidateHelper *helper, const gchar *text)
 {
@@ -168,9 +156,6 @@ as_app_validate_has_first_word_capital (AsAppValidateHelper *helper, const gchar
 	return FALSE;
 }
 
-/**
- * as_app_validate_description_li:
- **/
 static void
 as_app_validate_description_li (const gchar *text, AsAppValidateHelper *helper)
 {
@@ -224,9 +209,6 @@ as_app_validate_description_li (const gchar *text, AsAppValidateHelper *helper)
 	}
 }
 
-/**
- * as_app_validate_description_para:
- **/
 static void
 as_app_validate_description_para (const gchar *text, AsAppValidateHelper *helper)
 {
@@ -297,9 +279,6 @@ as_app_validate_description_para (const gchar *text, AsAppValidateHelper *helper
 	helper->para_chars_before_list += str_len;
 }
 
-/**
- * as_app_validate_description_list:
- **/
 static void
 as_app_validate_description_list (const gchar *text,
 				  gboolean allow_short_para,
@@ -335,9 +314,6 @@ as_app_validate_description_list (const gchar *text,
 	helper->para_chars_before_list = 0;
 }
 
-/**
- * as_app_validate_description:
- **/
 static gboolean
 as_app_validate_description (const gchar *xml,
 			     AsAppValidateHelper *helper,
@@ -414,9 +390,6 @@ as_app_validate_description (const gchar *xml,
 	return TRUE;
 }
 
-/**
- * as_app_validate_image_url_already_exists:
- */
 static gboolean
 as_app_validate_image_url_already_exists (AsAppValidateHelper *helper,
 					  const gchar *search)
@@ -432,9 +405,6 @@ as_app_validate_image_url_already_exists (AsAppValidateHelper *helper,
 	return FALSE;
 }
 
-/**
- * ai_app_validate_image_check:
- */
 static gboolean
 ai_app_validate_image_check (AsImage *im, AsAppValidateHelper *helper)
 {
@@ -607,9 +577,6 @@ ai_app_validate_image_check (AsImage *im, AsAppValidateHelper *helper)
 	return TRUE;
 }
 
-/**
- * as_app_validate_image:
- **/
 static void
 as_app_validate_image (AsImage *im, AsAppValidateHelper *helper)
 {
@@ -640,9 +607,6 @@ as_app_validate_image (AsImage *im, AsAppValidateHelper *helper)
 		g_ptr_array_add (helper->screenshot_urls, g_strdup (url));
 }
 
-/**
- * as_app_validate_screenshot:
- **/
 static void
 as_app_validate_screenshot (AsScreenshot *ss, AsAppValidateHelper *helper)
 {
@@ -707,9 +671,6 @@ as_app_validate_screenshot (AsScreenshot *ss, AsAppValidateHelper *helper)
 	}
 }
 
-/**
- * as_app_validate_icons:
- **/
 static void
 as_app_validate_icons (AsApp *app, AsAppValidateHelper *helper)
 {
@@ -767,9 +728,6 @@ as_app_validate_icons (AsApp *app, AsAppValidateHelper *helper)
 	}
 }
 
-/**
- * as_app_validate_screenshots:
- **/
 static void
 as_app_validate_screenshots (AsApp *app, AsAppValidateHelper *helper)
 {
@@ -830,9 +788,6 @@ as_app_validate_screenshots (AsApp *app, AsAppValidateHelper *helper)
 	}
 }
 
-/**
- * as_app_validate_release:
- **/
 static gboolean
 as_app_validate_release (AsApp *app,
 			 AsRelease *release,
@@ -899,9 +854,6 @@ as_app_validate_release (AsApp *app,
 	return TRUE;
 }
 
-/**
- * as_app_validate_releases:
- **/
 static gboolean
 as_app_validate_releases (AsApp *app, AsAppValidateHelper *helper, GError **error)
 {
@@ -928,9 +880,6 @@ as_app_validate_releases (AsApp *app, AsAppValidateHelper *helper, GError **erro
 	return TRUE;
 }
 
-/**
- * as_app_validate_setup_networking:
- **/
 static gboolean
 as_app_validate_setup_networking (AsAppValidateHelper *helper, GError **error)
 {
@@ -951,9 +900,6 @@ as_app_validate_setup_networking (AsAppValidateHelper *helper, GError **error)
 	return TRUE;
 }
 
-/**
- * as_app_validate_license:
- **/
 static gboolean
 as_app_validate_license (const gchar *license_text, GError **error)
 {
@@ -988,9 +934,6 @@ as_app_validate_license (const gchar *license_text, GError **error)
 	return TRUE;
 }
 
-/**
- * as_app_validate_is_content_license_id:
- **/
 static gboolean
 as_app_validate_is_content_license_id (const gchar *license_id)
 {
@@ -1027,9 +970,6 @@ as_app_validate_is_content_license_id (const gchar *license_id)
 	return FALSE;
 }
 
-/**
- * as_app_validate_is_content_license:
- **/
 static gboolean
 as_app_validate_is_content_license (const gchar *license)
 {
diff --git a/libappstream-glib/as-app.c b/libappstream-glib/as-app.c
index 27a6f55..4b5449b 100644
--- a/libappstream-glib/as-app.c
+++ b/libappstream-glib/as-app.c
@@ -348,9 +348,6 @@ as_app_guess_source_kind (const gchar *filename)
 	return AS_APP_SOURCE_KIND_UNKNOWN;
 }
 
-/**
- * as_app_finalize:
- **/
 static void
 as_app_finalize (GObject *object)
 {
@@ -398,9 +395,6 @@ as_app_finalize (GObject *object)
 	G_OBJECT_CLASS (as_app_parent_class)->finalize (object);
 }
 
-/**
- * as_app_init:
- **/
 static void
 as_app_init (AsApp *app)
 {
@@ -436,9 +430,6 @@ as_app_init (AsApp *app)
 	priv->token_cache = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, g_free);
 }
 
-/**
- * as_app_class_init:
- **/
 static void
 as_app_class_init (AsAppClass *klass)
 {
@@ -1594,9 +1585,6 @@ as_app_get_source_file (AsApp *app)
 	return priv->source_file;
 }
 
-/**
- * as_app_validate_utf8:
- **/
 static gboolean
 as_app_validate_utf8 (const gchar *text)
 {
@@ -2385,9 +2373,6 @@ as_app_add_mimetype (AsApp *app, const gchar *mimetype)
 	g_ptr_array_add (priv->mimetypes, g_strdup (mimetype));
 }
 
-/**
- * as_app_subsume_release:
- **/
 static void
 as_app_subsume_release (AsRelease *release, AsRelease *donor)
 {
@@ -2495,9 +2480,6 @@ as_app_add_provide (AsApp *app, AsProvide *provide)
 	g_ptr_array_add (priv->provides, g_object_ref (provide));
 }
 
-/**
- * as_app_sort_screenshots:
- **/
 static gint
 as_app_sort_screenshots (gconstpointer a, gconstpointer b)
 {
@@ -2564,9 +2546,6 @@ as_app_add_content_rating (AsApp *app, AsContentRating *content_rating)
 	g_ptr_array_add (priv->content_ratings, g_object_ref (content_rating));
 }
 
-/**
- * as_app_check_icon_duplicate:
- **/
 static gboolean
 as_app_check_icon_duplicate (AsIcon *icon1, AsIcon *icon2)
 {
@@ -2580,9 +2559,6 @@ as_app_check_icon_duplicate (AsIcon *icon1, AsIcon *icon2)
 	return TRUE;
 }
 
-/**
- * as_app_check_bundle_duplicate:
- **/
 static gboolean
 as_app_check_bundle_duplicate (AsBundle *bundle1, AsBundle *bundle2)
 {
@@ -2594,9 +2570,6 @@ as_app_check_bundle_duplicate (AsBundle *bundle1, AsBundle *bundle2)
 	return TRUE;
 }
 
-/**
- * as_app_check_translation_duplicate:
- **/
 static gboolean
 as_app_check_translation_duplicate (AsTranslation *translation1, AsTranslation *translation2)
 {
@@ -2918,9 +2891,6 @@ as_app_add_addon (AsApp *app, AsApp *addon)
 /******************************************************************************/
 
 
-/**
- * as_app_subsume_dict:
- **/
 static void
 as_app_subsume_dict (GHashTable *dest, GHashTable *src, gboolean overwrite)
 {
@@ -2943,9 +2913,6 @@ as_app_subsume_dict (GHashTable *dest, GHashTable *src, gboolean overwrite)
 	}
 }
 
-/**
- * as_app_subsume_keywords:
- **/
 static void
 as_app_subsume_keywords (AsApp *app, AsApp *donor, gboolean overwrite)
 {
@@ -2978,9 +2945,6 @@ as_app_subsume_keywords (AsApp *app, AsApp *donor, gboolean overwrite)
 	}
 }
 
-/**
- * as_app_subsume_icon:
- **/
 static void
 as_app_subsume_icon (AsApp *app, AsIcon *icon)
 {
@@ -3007,9 +2971,6 @@ as_app_subsume_icon (AsApp *app, AsIcon *icon)
 	as_app_add_icon (app, icon);
 }
 
-/**
- * as_app_subsume_private:
- **/
 static void
 as_app_subsume_private (AsApp *app, AsApp *donor, AsAppSubsumeFlags flags)
 {
@@ -3228,18 +3189,12 @@ as_app_subsume (AsApp *app, AsApp *donor)
 	as_app_subsume_full (app, donor, AS_APP_SUBSUME_FLAG_NONE);
 }
 
-/**
- * gs_app_node_language_sort_cb:
- **/
 static gint
 gs_app_node_language_sort_cb (gconstpointer a, gconstpointer b)
 {
 	return g_strcmp0 ((const gchar *) a, (const gchar *) b);
 }
 
-/**
- * as_app_node_insert_languages:
- **/
 static void
 as_app_node_insert_languages (AsApp *app, GNode *parent)
 {
@@ -3267,18 +3222,12 @@ as_app_node_insert_languages (AsApp *app, GNode *parent)
 	}
 }
 
-/**
- * as_app_ptr_array_sort_cb:
- **/
 static gint
 as_app_ptr_array_sort_cb (gconstpointer a, gconstpointer b)
 {
 	return g_strcmp0 (*((const gchar **) a), *((const gchar **) b));
 }
 
-/**
- * as_app_releases_sort_cb:
- **/
 static gint
 as_app_releases_sort_cb (gconstpointer a, gconstpointer b)
 {
@@ -3287,9 +3236,6 @@ as_app_releases_sort_cb (gconstpointer a, gconstpointer b)
 	return as_release_vercmp (*rel1, *rel2);
 }
 
-/**
- * as_app_provides_sort_cb:
- **/
 static gint
 as_app_provides_sort_cb (gconstpointer a, gconstpointer b)
 {
@@ -3304,9 +3250,6 @@ as_app_provides_sort_cb (gconstpointer a, gconstpointer b)
 			  as_provide_get_value (prov2));
 }
 
-/**
- * as_app_icons_sort_cb:
- **/
 static gint
 as_app_icons_sort_cb (gconstpointer a, gconstpointer b)
 {
@@ -3315,18 +3258,12 @@ as_app_icons_sort_cb (gconstpointer a, gconstpointer b)
 	return g_strcmp0 (as_icon_get_name (*ic1), as_icon_get_name (*ic2));
 }
 
-/**
- * as_app_list_sort_cb:
- **/
 static gint
 as_app_list_sort_cb (gconstpointer a, gconstpointer b)
 {
 	return g_strcmp0 ((const gchar *) a, (const gchar *) b);
 }
 
-/**
- * as_app_node_insert_keywords:
- **/
 static void
 as_app_node_insert_keywords (AsApp *app, GNode *parent, AsNodeContext *ctx)
 {
@@ -3643,9 +3580,6 @@ as_app_node_insert (AsApp *app, GNode *parent, AsNodeContext *ctx)
 	return node_app;
 }
 
-/**
- * as_app_node_parse_child:
- **/
 static gboolean
 as_app_node_parse_child (AsApp *app, GNode *n, AsAppParseFlags flags,
 			 AsNodeContext *ctx, GError **error)
@@ -4047,9 +3981,6 @@ as_app_node_parse_child (AsApp *app, GNode *n, AsAppParseFlags flags,
 	return TRUE;
 }
 
-/**
- * as_app_check_for_hidpi_icons:
- **/
 static void
 as_app_check_for_hidpi_icons (AsApp *app)
 {
@@ -4076,9 +4007,6 @@ as_app_check_for_hidpi_icons (AsApp *app)
 	as_app_add_icon (app, icon_hidpi);
 }
 
-/**
- * as_app_node_parse_full:
- **/
 static gboolean
 as_app_node_parse_full (AsApp *app, GNode *node, AsAppParseFlags flags,
 			AsNodeContext *ctx, GError **error)
@@ -4143,9 +4071,6 @@ as_app_node_parse (AsApp *app, GNode *node, AsNodeContext *ctx, GError **error)
 	return as_app_node_parse_full (app, node, AS_APP_PARSE_FLAG_NONE, ctx, error);
 }
 
-/**
- * as_app_node_parse_dep11_icons:
- **/
 static gboolean
 as_app_node_parse_dep11_icons (AsApp *app, GNode *node,
 			       AsNodeContext *ctx, GError **error)
@@ -4419,9 +4344,6 @@ as_app_node_parse_dep11 (AsApp *app, GNode *node,
 	return TRUE;
 }
 
-/**
- * as_app_value_tokenize:
- **/
 static gchar **
 as_app_value_tokenize (const gchar *value)
 {
@@ -4439,9 +4361,6 @@ as_app_value_tokenize (const gchar *value)
 	return values;
 }
 
-/**
- * as_app_add_token_internal:
- **/
 static void
 as_app_add_token_internal (AsApp *app,
 			   const gchar *value,
@@ -4471,9 +4390,6 @@ as_app_add_token_internal (AsApp *app,
 			     match_pval);
 }
 
-/**
- * as_app_add_token:
- **/
 static void
 as_app_add_token (AsApp *app,
 		  const gchar *value,
@@ -4492,9 +4408,6 @@ as_app_add_token (AsApp *app,
 	as_app_add_token_internal (app, value, match_flag);
 }
 
-/**
- * as_app_add_tokens:
- **/
 static void
 as_app_add_tokens (AsApp *app,
 		   const gchar *value,
@@ -4530,9 +4443,6 @@ as_app_add_tokens (AsApp *app,
 		as_app_add_token (app, values_ascii[i], allow_split, match_flag);
 }
 
-/**
- * as_app_create_token_cache_target:
- **/
 static void
 as_app_create_token_cache_target (AsApp *app, AsApp *donor)
 {
@@ -4586,9 +4496,6 @@ as_app_create_token_cache_target (AsApp *app, AsApp *donor)
 	}
 }
 
-/**
- * as_app_create_token_cache:
- **/
 static void
 as_app_create_token_cache (AsApp *app)
 {
@@ -4716,9 +4623,6 @@ as_app_search_matches_all (AsApp *app, gchar **search)
 	return matches_sum;
 }
 
-/**
- * as_app_parse_appdata_unintltoolize_cb:
- **/
 static gboolean
 as_app_parse_appdata_unintltoolize_cb (GNode *node, gpointer data)
 {
@@ -4763,9 +4667,6 @@ as_app_parse_appdata_unintltoolize_cb (GNode *node, gpointer data)
 	return FALSE;
 }
 
-/**
- * as_app_parse_appdata_guess_project_group:
- **/
 static void
 as_app_parse_appdata_guess_project_group (AsApp *app)
 {
@@ -4808,9 +4709,6 @@ as_app_parse_appdata_guess_project_group (AsApp *app)
 	}
 }
 
-/**
- * as_app_parse_appdata_file:
- **/
 static gboolean
 as_app_parse_appdata_file (AsApp *app,
 			   const gchar *filename,
diff --git a/libappstream-glib/as-bundle.c b/libappstream-glib/as-bundle.c
index a4eafa5..206844b 100644
--- a/libappstream-glib/as-bundle.c
+++ b/libappstream-glib/as-bundle.c
@@ -51,9 +51,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsBundle, as_bundle, G_TYPE_OBJECT)
 
 #define GET_PRIVATE(o) (as_bundle_get_instance_private (o))
 
-/**
- * as_bundle_finalize:
- **/
 static void
 as_bundle_finalize (GObject *object)
 {
@@ -67,17 +64,11 @@ as_bundle_finalize (GObject *object)
 	G_OBJECT_CLASS (as_bundle_parent_class)->finalize (object);
 }
 
-/**
- * as_bundle_init:
- **/
 static void
 as_bundle_init (AsBundle *bundle)
 {
 }
 
-/**
- * as_bundle_class_init:
- **/
 static void
 as_bundle_class_init (AsBundleClass *klass)
 {
diff --git a/libappstream-glib/as-checksum.c b/libappstream-glib/as-checksum.c
index 3901705..cbdbedd 100644
--- a/libappstream-glib/as-checksum.c
+++ b/libappstream-glib/as-checksum.c
@@ -51,9 +51,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsChecksum, as_checksum, G_TYPE_OBJECT)
 
 #define AS_CHECKSUM_UNKNOWN	((guint) -1)
 
-/**
- * as_checksum_finalize:
- **/
 static void
 as_checksum_finalize (GObject *object)
 {
@@ -66,9 +63,6 @@ as_checksum_finalize (GObject *object)
 	G_OBJECT_CLASS (as_checksum_parent_class)->finalize (object);
 }
 
-/**
- * as_checksum_init:
- **/
 static void
 as_checksum_init (AsChecksum *checksum)
 {
@@ -76,9 +70,6 @@ as_checksum_init (AsChecksum *checksum)
 	priv->kind = AS_CHECKSUM_UNKNOWN;
 }
 
-/**
- * as_checksum_class_init:
- **/
 static void
 as_checksum_class_init (AsChecksumClass *klass)
 {
@@ -261,9 +252,6 @@ as_checksum_set_target (AsChecksum *checksum, AsChecksumTarget target)
 	priv->target = target;
 }
 
-/**
- * _g_checksum_type_from_string:
- **/
 static GChecksumType
 _g_checksum_type_from_string (const gchar *checksum_type)
 {
@@ -278,9 +266,6 @@ _g_checksum_type_from_string (const gchar *checksum_type)
 	return -1;
 }
 
-/**
- * _g_checksum_type_to_string:
- **/
 static const gchar *
 _g_checksum_type_to_string (GChecksumType checksum_type)
 {
diff --git a/libappstream-glib/as-content-rating.c b/libappstream-glib/as-content-rating.c
index 2d5ad23..510bcb4 100644
--- a/libappstream-glib/as-content-rating.c
+++ b/libappstream-glib/as-content-rating.c
@@ -51,9 +51,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsContentRating, as_content_rating, G_TYPE_OBJECT)
 
 #define GET_PRIVATE(o) (as_content_rating_get_instance_private (o))
 
-/**
- * as_content_rating_finalize:
- **/
 static void
 as_content_rating_finalize (GObject *object)
 {
@@ -66,9 +63,6 @@ as_content_rating_finalize (GObject *object)
 	G_OBJECT_CLASS (as_content_rating_parent_class)->finalize (object);
 }
 
-/**
- * as_content_rating_key_free:
- **/
 static void
 as_content_rating_key_free (AsContentRatingKey *key)
 {
@@ -76,9 +70,6 @@ as_content_rating_key_free (AsContentRatingKey *key)
 	g_free (key);
 }
 
-/**
- * as_content_rating_init:
- **/
 static void
 as_content_rating_init (AsContentRating *content_rating)
 {
@@ -86,9 +77,6 @@ as_content_rating_init (AsContentRating *content_rating)
 	priv->keys = g_ptr_array_new_with_free_func ((GDestroyNotify) as_content_rating_key_free);
 }
 
-/**
- * as_content_rating_class_init:
- **/
 static void
 as_content_rating_class_init (AsContentRatingClass *klass)
 {
diff --git a/libappstream-glib/as-icon.c b/libappstream-glib/as-icon.c
index df719a9..bceaf78 100644
--- a/libappstream-glib/as-icon.c
+++ b/libappstream-glib/as-icon.c
@@ -66,9 +66,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsIcon, as_icon, G_TYPE_OBJECT)
  **/
 G_DEFINE_QUARK (as-icon-error-quark, as_icon_error)
 
-/**
- * as_icon_finalize:
- **/
 static void
 as_icon_finalize (GObject *object)
 {
@@ -88,17 +85,11 @@ as_icon_finalize (GObject *object)
 	G_OBJECT_CLASS (as_icon_parent_class)->finalize (object);
 }
 
-/**
- * as_icon_init:
- **/
 static void
 as_icon_init (AsIcon *icon)
 {
 }
 
-/**
- * as_icon_class_init:
- **/
 static void
 as_icon_class_init (AsIconClass *klass)
 {
@@ -475,9 +466,6 @@ as_icon_set_data (AsIcon *icon, GBytes *data)
 	priv->data = g_bytes_ref (data);
 }
 
-/**
- * as_icon_node_insert_embedded:
- **/
 static GNode *
 as_icon_node_insert_embedded (AsIcon *icon, GNode *parent, AsNodeContext *ctx)
 {
@@ -557,9 +545,6 @@ as_icon_node_insert (AsIcon *icon, GNode *parent, AsNodeContext *ctx)
 	return n;
 }
 
-/**
- * as_icon_node_parse_embedded:
- **/
 static gboolean
 as_icon_node_parse_embedded (AsIcon *icon, GNode *n, GError **error)
 {
diff --git a/libappstream-glib/as-image.c b/libappstream-glib/as-image.c
index 43abd39..dff68f7 100644
--- a/libappstream-glib/as-image.c
+++ b/libappstream-glib/as-image.c
@@ -55,9 +55,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsImage, as_image, G_TYPE_OBJECT)
 
 #define GET_PRIVATE(o) (as_image_get_instance_private (o))
 
-/**
- * as_image_finalize:
- **/
 static void
 as_image_finalize (GObject *object)
 {
@@ -74,17 +71,11 @@ as_image_finalize (GObject *object)
 	G_OBJECT_CLASS (as_image_parent_class)->finalize (object);
 }
 
-/**
- * as_image_init:
- **/
 static void
 as_image_init (AsImage *image)
 {
 }
 
-/**
- * as_image_class_init:
- **/
 static void
 as_image_class_init (AsImageClass *klass)
 {
@@ -838,9 +829,6 @@ as_image_save_filename (AsImage *image,
 				NULL);
 }
 
-/**
- * is_pixel_alpha:
- **/
 static gboolean
 is_pixel_alpha (GdkPixbuf *pixbuf, guint x, guint y)
 {
diff --git a/libappstream-glib/as-inf.c b/libappstream-glib/as-inf.c
index a858958..d1523e9 100644
--- a/libappstream-glib/as-inf.c
+++ b/libappstream-glib/as-inf.c
@@ -60,9 +60,6 @@ typedef struct {
 	AsInfLoadFlags		 flags;
 } AsInfHelper;
 
-/**
- * as_inf_make_case_insensitive:
- */
 static gchar *
 as_inf_make_case_insensitive (AsInfHelper *helper, const gchar *text)
 {
@@ -71,9 +68,6 @@ as_inf_make_case_insensitive (AsInfHelper *helper, const gchar *text)
 	return g_strdup (text);
 }
 
-/**
- * as_inf_string_isdigits:
- */
 static gboolean
 as_inf_string_isdigits (const gchar *str)
 {
@@ -85,11 +79,6 @@ as_inf_string_isdigits (const gchar *str)
 	return TRUE;
 }
 
-/**
- * as_inf_replace_variable:
- *
- * Replaces any instance of %val% with the 'val' key value found in @dict.
- */
 static gchar *
 as_inf_replace_variable (AsInfHelper *helper, const gchar *line, GError **error)
 {
@@ -138,11 +127,6 @@ as_inf_replace_variable (AsInfHelper *helper, const gchar *line, GError **error)
 	return g_string_free (new, FALSE);
 }
 
-/**
- * as_inf_get_dict:
- *
- * Puts all the strings in [Strings] into a hash table.
- */
 static GHashTable *
 as_inf_get_dict (AsInfHelper *helper, GError **error)
 {
@@ -188,11 +172,6 @@ out:
 	return dict;
 }
 
-/**
- * as_inf_replace_variables:
- *
- * Replaces any key file value with it's substitution from [Strings]
- */
 static gboolean
 as_inf_replace_variables (AsInfHelper *helper, GError **error)
 {
@@ -245,9 +224,6 @@ as_inf_replace_variables (AsInfHelper *helper, GError **error)
 	return TRUE;
 }
 
-/**
- * as_inf_set_last_key:
- */
 static void
 as_inf_set_last_key (AsInfHelper *helper, const gchar *key)
 {
@@ -258,9 +234,6 @@ as_inf_set_last_key (AsInfHelper *helper, const gchar *key)
 	helper->last_key = g_strdup (key);
 }
 
-/**
- * as_inf_set_comment:
- */
 static void
 as_inf_set_comment (AsInfHelper *helper, const gchar *comment)
 {
@@ -274,9 +247,6 @@ as_inf_set_comment (AsInfHelper *helper, const gchar *comment)
 		g_strchug (helper->comment);
 }
 
-/**
- * as_inf_strcheckchars:
- */
 static gboolean
 as_inf_strcheckchars (const gchar *str, const gchar *chars)
 {
@@ -291,11 +261,6 @@ as_inf_strcheckchars (const gchar *str, const gchar *chars)
 	return FALSE;
 }
 
-/**
- * as_inf_strip_value:
- *
- * Strips off any comments and quotes from the .inf key value.
- */
 static gboolean
 as_inf_strip_value (AsInfHelper *helper, gchar *value, GError **error)
 {
@@ -346,9 +311,6 @@ as_inf_strip_value (AsInfHelper *helper, gchar *value, GError **error)
 	return TRUE;
 }
 
-/**
- * as_inf_set_group:
- */
 static gboolean
 as_inf_set_group (AsInfHelper *helper, const gchar *group, GError **error)
 {
@@ -427,9 +389,6 @@ as_inf_set_group (AsInfHelper *helper, const gchar *group, GError **error)
 	return TRUE;
 }
 
-/**
- * as_inf_set_key:
- */
 static void
 as_inf_set_key (AsInfHelper *helper, const gchar *key, const gchar *value)
 {
@@ -446,9 +405,6 @@ as_inf_set_key (AsInfHelper *helper, const gchar *key, const gchar *value)
 	as_inf_set_last_key (helper, key);
 }
 
-/**
- * as_inf_convert_key:
- */
 static void
 as_inf_convert_key (gchar *key)
 {
@@ -462,9 +418,6 @@ as_inf_convert_key (gchar *key)
 	}
 }
 
-/**
- * as_inf_repair_utf8:
- */
 static gboolean
 as_inf_repair_utf8 (AsInfHelper *helper, gchar *line, GError **error)
 {
@@ -490,9 +443,6 @@ as_inf_repair_utf8 (AsInfHelper *helper, gchar *line, GError **error)
 	return TRUE;
 }
 
-/**
- * as_inf_parse_line:
- */
 static gboolean
 as_inf_parse_line (AsInfHelper *helper, gchar *line, GError **error)
 {
@@ -752,9 +702,6 @@ out:
 	return ret;
 }
 
-/**
- * as_inf_helper_new:
- */
 static AsInfHelper *
 as_inf_helper_new (void)
 {
@@ -763,9 +710,6 @@ as_inf_helper_new (void)
 	return helper;
 }
 
-/**
- * as_inf_helper_free:
- */
 static void
 as_inf_helper_free (AsInfHelper *helper)
 {
diff --git a/libappstream-glib/as-markup.c b/libappstream-glib/as-markup.c
index 8cf5c93..8870131 100644
--- a/libappstream-glib/as-markup.c
+++ b/libappstream-glib/as-markup.c
@@ -52,9 +52,6 @@ typedef struct {
 	GString		*temp;
 } AsMarkupImportHelper;
 
-/**
- * as_markup_import_html_flush:
- **/
 static void
 as_markup_import_html_flush (AsMarkupImportHelper *helper)
 {
@@ -88,9 +85,6 @@ as_markup_import_html_flush (AsMarkupImportHelper *helper)
 	g_string_truncate (helper->temp, 0);
 }
 
-/**
- * as_markup_import_html_set_tag:
- **/
 static void
 as_markup_import_html_set_tag (AsMarkupImportHelper *helper, AsMarkupTag action_new)
 {
@@ -107,9 +101,6 @@ as_markup_import_html_set_tag (AsMarkupImportHelper *helper, AsMarkupTag action_
 	}
 }
 
-/**
- * as_markup_import_html_start_cb:
- **/
 static void
 as_markup_import_html_start_cb (GMarkupParseContext *context,
 				const gchar *element_name,
@@ -145,9 +136,6 @@ as_markup_import_html_start_cb (GMarkupParseContext *context,
 	}
 }
 
-/**
- * as_markup_import_html_end_cb:
- **/
 static void
 as_markup_import_html_end_cb (GMarkupParseContext *context,
 			      const gchar *element_name,
@@ -183,9 +171,6 @@ as_markup_import_html_end_cb (GMarkupParseContext *context,
 	}
 }
 
-/**
- * as_markup_import_html_text_cb:
- **/
 static void
 as_markup_import_html_text_cb (GMarkupParseContext *context,
 			       const gchar *text,
@@ -204,11 +189,6 @@ as_markup_import_html_text_cb (GMarkupParseContext *context,
 	g_string_append (helper->temp, tmp);
 }
 
-/**
- * as_markup_import_html_erase:
- *
- * Replaces any tag with whitespace.
- **/
 static void
 as_markup_import_html_erase (GString *str, const gchar *start, const gchar *end)
 {
@@ -229,9 +209,6 @@ as_markup_import_html_erase (GString *str, const gchar *start, const gchar *end)
 	}
 }
 
-/**
- * as_markup_import_html:
- **/
 static gchar *
 as_markup_import_html (const gchar *text, GError **error)
 {
@@ -291,9 +268,6 @@ as_markup_import_html (const gchar *text, GError **error)
 				       error);
 }
 
-/**
- * as_markup_import_simple:
- */
 static gchar *
 as_markup_import_simple (const gchar *text, GError **error)
 {
@@ -412,9 +386,6 @@ as_markup_strsplit_words (const gchar *text, guint line_len)
 	return (gchar **) g_ptr_array_free (lines, FALSE);
 }
 
-/**
- * as_markup_render_para:
- **/
 static void
 as_markup_render_para (GString *str, AsMarkupConvertFormat format, const gchar *data)
 {
@@ -443,9 +414,6 @@ as_markup_render_para (GString *str, AsMarkupConvertFormat format, const gchar *
 	}
 }
 
-/**
- * as_markup_render_li:
- **/
 static void
 as_markup_render_li (GString *str, AsMarkupConvertFormat format, const gchar *data)
 {
@@ -473,9 +441,6 @@ as_markup_render_li (GString *str, AsMarkupConvertFormat format, const gchar *da
 	}
 }
 
-/**
- * as_markup_render_ul_start:
- **/
 static void
 as_markup_render_ul_start (GString *str, AsMarkupConvertFormat format)
 {
@@ -488,9 +453,6 @@ as_markup_render_ul_start (GString *str, AsMarkupConvertFormat format)
 	}
 }
 
-/**
- * as_markup_render_ul_end:
- **/
 static void
 as_markup_render_ul_end (GString *str, AsMarkupConvertFormat format)
 {
diff --git a/libappstream-glib/as-monitor.c b/libappstream-glib/as-monitor.c
index 668fb71..1066fee 100644
--- a/libappstream-glib/as-monitor.c
+++ b/libappstream-glib/as-monitor.c
@@ -66,9 +66,6 @@ static guint signals [SIGNAL_LAST] = { 0 };
  **/
 G_DEFINE_QUARK (as-monitor-error-quark, as_monitor_error)
 
-/**
- * as_monitor_finalize:
- **/
 static void
 as_monitor_finalize (GObject *object)
 {
@@ -86,9 +83,6 @@ as_monitor_finalize (GObject *object)
 	G_OBJECT_CLASS (as_monitor_parent_class)->finalize (object);
 }
 
-/**
- * as_monitor_init:
- **/
 static void
 as_monitor_init (AsMonitor *monitor)
 {
@@ -100,9 +94,6 @@ as_monitor_init (AsMonitor *monitor)
 	priv->queue_temp = g_ptr_array_new_with_free_func (g_free);
 }
 
-/**
- * as_monitor_class_init:
- **/
 static void
 as_monitor_class_init (AsMonitorClass *klass)
 {
@@ -159,9 +150,6 @@ as_monitor_class_init (AsMonitorClass *klass)
 	object_class->finalize = as_monitor_finalize;
 }
 
-/**
- * _g_file_monitor_to_string:
- */
 static const gchar *
 _g_file_monitor_to_string (GFileMonitorEvent ev)
 {
@@ -184,9 +172,6 @@ _g_file_monitor_to_string (GFileMonitorEvent ev)
 	return NULL;
 }
 
-/**
- * _g_ptr_array_str_find:
- */
 static const gchar *
 _g_ptr_array_str_find (GPtrArray *array, const gchar *fn)
 {
@@ -200,9 +185,6 @@ _g_ptr_array_str_find (GPtrArray *array, const gchar *fn)
 	return NULL;
 }
 
-/**
- * _g_ptr_array_str_remove:
- */
 static gboolean
 _g_ptr_array_str_remove (GPtrArray *array, const gchar *fn)
 {
@@ -218,9 +200,6 @@ _g_ptr_array_str_remove (GPtrArray *array, const gchar *fn)
 	return FALSE;
 }
 
-/**
- * _g_ptr_array_str_add:
- */
 static void
 _g_ptr_array_str_add (GPtrArray *array, const gchar *fn)
 {
@@ -229,9 +208,6 @@ _g_ptr_array_str_add (GPtrArray *array, const gchar *fn)
 	g_ptr_array_add (array, g_strdup (fn));
 }
 
-/**
- * as_monitor_emit_added:
- */
 static void
 as_monitor_emit_added (AsMonitor *monitor, const gchar *filename)
 {
@@ -241,9 +217,6 @@ as_monitor_emit_added (AsMonitor *monitor, const gchar *filename)
 	_g_ptr_array_str_add (priv->files, filename);
 }
 
-/**
- * as_monitor_emit_removed:
- */
 static void
 as_monitor_emit_removed (AsMonitor *monitor, const gchar *filename)
 {
@@ -253,9 +226,6 @@ as_monitor_emit_removed (AsMonitor *monitor, const gchar *filename)
 	_g_ptr_array_str_remove (priv->files, filename);
 }
 
-/**
- * as_monitor_emit_changed:
- */
 static void
 as_monitor_emit_changed (AsMonitor *monitor, const gchar *filename)
 {
@@ -263,9 +233,6 @@ as_monitor_emit_changed (AsMonitor *monitor, const gchar *filename)
 	g_signal_emit (monitor, signals[SIGNAL_CHANGED], 0, filename);
 }
 
-/**
- * as_monitor_process_pending:
- **/
 static void
 as_monitor_process_pending (AsMonitor *monitor)
 {
@@ -300,9 +267,6 @@ as_monitor_process_pending (AsMonitor *monitor)
 	g_ptr_array_set_size (priv->queue_add, 0);
 }
 
-/**
- * as_monitor_process_pending_trigger_cb:
- **/
 static gboolean
 as_monitor_process_pending_trigger_cb (gpointer user_data)
 {
@@ -315,9 +279,6 @@ as_monitor_process_pending_trigger_cb (gpointer user_data)
 	return FALSE;
 }
 
-/**
- * as_monitor_process_pending_trigger:
- **/
 static void
 as_monitor_process_pending_trigger (AsMonitor *monitor)
 {
diff --git a/libappstream-glib/as-node.c b/libappstream-glib/as-node.c
index bef6fbf..8040527 100644
--- a/libappstream-glib/as-node.c
+++ b/libappstream-glib/as-node.c
@@ -73,9 +73,6 @@ as_node_new (void)
 	return g_node_new (data);
 }
 
-/**
- * as_node_attr_free:
- **/
 static void
 as_node_attr_free (AsNodeAttr *attr)
 {
@@ -83,9 +80,6 @@ as_node_attr_free (AsNodeAttr *attr)
 	g_slice_free (AsNodeAttr, attr);
 }
 
-/**
- * as_node_attr_insert:
- **/
 static AsNodeAttr *
 as_node_attr_insert (AsNodeData *data, const gchar *key, const gchar *value)
 {
@@ -97,9 +91,6 @@ as_node_attr_insert (AsNodeData *data, const gchar *key, const gchar *value)
 	return attr;
 }
 
-/**
- * as_node_attr_find:
- **/
 static AsNodeAttr *
 as_node_attr_find (AsNodeData *data, const gchar *key)
 {
@@ -114,9 +105,6 @@ as_node_attr_find (AsNodeData *data, const gchar *key)
 	return NULL;
 }
 
-/**
- * as_node_attr_lookup:
- **/
 static const gchar *
 as_node_attr_lookup (AsNodeData *data, const gchar *key)
 {
@@ -127,9 +115,6 @@ as_node_attr_lookup (AsNodeData *data, const gchar *key)
 	return NULL;
 }
 
-/**
- * as_node_destroy_node_cb:
- **/
 static gboolean
 as_node_destroy_node_cb (AsNode *node, gpointer user_data)
 {
@@ -172,9 +157,6 @@ as_node_unref (AsNode *node)
  **/
 G_DEFINE_QUARK (as-node-error-quark, as_node_error)
 
-/**
- * as_node_string_replace_inplace:
- **/
 static void
 as_node_string_replace_inplace (gchar *text,
 				const gchar *search,
@@ -197,9 +179,6 @@ as_node_string_replace_inplace (gchar *text,
 	}
 }
 
-/**
- * as_node_cdata_to_raw:
- **/
 static void
 as_node_cdata_to_raw (AsNodeData *data)
 {
@@ -211,9 +190,6 @@ as_node_cdata_to_raw (AsNodeData *data)
 	data->cdata_escaped = FALSE;
 }
 
-/**
- * as_node_cdata_to_escaped:
- **/
 static void
 as_node_cdata_to_escaped (AsNodeData *data)
 {
@@ -229,9 +205,6 @@ as_node_cdata_to_escaped (AsNodeData *data)
 	data->cdata_escaped = TRUE;
 }
 
-/**
- * as_node_add_padding:
- **/
 static void
 as_node_add_padding (GString *xml, guint depth)
 {
@@ -240,9 +213,6 @@ as_node_add_padding (GString *xml, guint depth)
 		g_string_append (xml, "  ");
 }
 
-/**
- * as_node_get_attr_string:
- **/
 static gchar *
 as_node_get_attr_string (AsNodeData *data)
 {
@@ -262,9 +232,6 @@ as_node_get_attr_string (AsNodeData *data)
 	return g_string_free (str, FALSE);
 }
 
-/**
- * as_tag_data_get_name:
- **/
 static const gchar *
 as_tag_data_get_name (AsNodeData *data)
 {
@@ -273,9 +240,6 @@ as_tag_data_get_name (AsNodeData *data)
 	return data->name;
 }
 
-/**
- * as_node_data_set_name:
- **/
 static void
 as_node_data_set_name (AsNodeData *data, const gchar *name, AsNodeInsertFlags flags)
 {
@@ -290,9 +254,6 @@ as_node_data_set_name (AsNodeData *data, const gchar *name, AsNodeInsertFlags fl
 	}
 }
 
-/**
- * as_node_sort_children:
- **/
 static void
 as_node_sort_children (AsNode *first)
 {
@@ -319,9 +280,6 @@ as_node_sort_children (AsNode *first)
 		as_node_sort_children (first->next);
 }
 
-/**
- * as_node_to_xml_string:
- **/
 static void
 as_node_to_xml_string (GString *xml,
 		       guint depth_offset,
@@ -502,9 +460,6 @@ as_node_to_xml (const AsNode *node, AsNodeToXmlFlags flags)
 	return xml;
 }
 
-/**
- * as_node_start_element_cb:
- **/
 static void
 as_node_start_element_cb (GMarkupParseContext *context,
 			  const gchar *element_name,
@@ -542,9 +497,6 @@ as_node_start_element_cb (GMarkupParseContext *context,
 	helper->current = current;
 }
 
-/**
- * as_node_end_element_cb:
- **/
 static void
 as_node_end_element_cb (GMarkupParseContext *context,
 			const gchar         *element_name,
@@ -555,9 +507,6 @@ as_node_end_element_cb (GMarkupParseContext *context,
 	helper->current = helper->current->parent;
 }
 
-/**
- * as_node_text_cb:
- **/
 static void
 as_node_text_cb (GMarkupParseContext *context,
 		 const gchar         *text,
@@ -599,9 +548,6 @@ as_node_text_cb (GMarkupParseContext *context,
 	}
 }
 
-/**
- * as_node_passthrough_cb:
- **/
 static void
 as_node_passthrough_cb (GMarkupParseContext *context,
 			const gchar         *passthrough_text,
@@ -860,9 +806,6 @@ as_node_from_file (GFile *file,
 	return root;
 }
 
-/**
- * as_node_get_child_node:
- **/
 static AsNode *
 as_node_get_child_node (const AsNode *root, const gchar *name,
 			const gchar *attr_key, const gchar *attr_value)
@@ -1310,9 +1253,6 @@ as_node_find_with_attribute (AsNode *root, const gchar *path,
 	return node;
 }
 
-/**
- * as_node_insert_line_breaks:
- **/
 static gchar *
 as_node_insert_line_breaks (const gchar *text, guint break_len)
 {
@@ -1388,9 +1328,6 @@ as_node_insert (AsNode *parent,
 	return g_node_insert_data (parent, -1, data);
 }
 
-/**
- * as_node_list_sort_cb:
- **/
 static gint
 as_node_list_sort_cb (gconstpointer a, gconstpointer b)
 {
@@ -1587,18 +1524,12 @@ as_node_get_localized_best (const AsNode *node, const gchar *key)
 	return as_hash_lookup_by_locale (hash, NULL);
 }
 
-/**
- * as_node_string_free:
- **/
 static void
 as_node_string_free (GString *string)
 {
 	g_string_free (string, TRUE);
 }
 
-/**
- * as_node_denorm_add_to_langs:
- **/
 static void
 as_node_denorm_add_to_langs (GHashTable *hash,
 			     const gchar *data,
@@ -1620,9 +1551,6 @@ as_node_denorm_add_to_langs (GHashTable *hash,
 	}
 }
 
-/**
- * as_node_denorm_get_str_for_lang:
- **/
 static GString *
 as_node_denorm_get_str_for_lang (GHashTable *hash,
 				AsNodeData *data,
diff --git a/libappstream-glib/as-problem.c b/libappstream-glib/as-problem.c
index d8c850d..69fe25a 100644
--- a/libappstream-glib/as-problem.c
+++ b/libappstream-glib/as-problem.c
@@ -45,9 +45,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsProblem, as_problem, G_TYPE_OBJECT)
 
 #define GET_PRIVATE(o) (as_problem_get_instance_private (o))
 
-/**
- * as_problem_finalize:
- **/
 static void
 as_problem_finalize (GObject *object)
 {
@@ -59,9 +56,6 @@ as_problem_finalize (GObject *object)
 	G_OBJECT_CLASS (as_problem_parent_class)->finalize (object);
 }
 
-/**
- * as_problem_init:
- **/
 static void
 as_problem_init (AsProblem *problem)
 {
@@ -70,9 +64,6 @@ as_problem_init (AsProblem *problem)
 	priv->line_number = 0;
 }
 
-/**
- * as_problem_class_init:
- **/
 static void
 as_problem_class_init (AsProblemClass *klass)
 {
diff --git a/libappstream-glib/as-profile.c b/libappstream-glib/as-profile.c
index b2286f2..c6833db 100644
--- a/libappstream-glib/as-profile.c
+++ b/libappstream-glib/as-profile.c
@@ -51,9 +51,6 @@ struct _AsProfileTask
 
 static gpointer as_profile_object = NULL;
 
-/**
- * as_profile_item_free:
- **/
 static void
 as_profile_item_free (AsProfileItem *item)
 {
@@ -61,9 +58,6 @@ as_profile_item_free (AsProfileItem *item)
 	g_free (item);
 }
 
-/**
- * as_profile_item_find:
- **/
 static AsProfileItem *
 as_profile_item_find (GPtrArray *array, const gchar *id)
 {
@@ -156,9 +150,6 @@ as_profile_start_literal (AsProfile *profile, const gchar *id)
 	return ptask;
 }
 
-/**
- * as_profile_task_free_internal:
- **/
 static void
 as_profile_task_free_internal (AsProfile *profile, const gchar *id)
 {
@@ -219,9 +210,6 @@ as_profile_task_free (AsProfileTask *ptask)
 	g_free (ptask);
 }
 
-/**
- * as_profile_sort_cb:
- **/
 static gint
 as_profile_sort_cb (gconstpointer a, gconstpointer b)
 {
@@ -326,9 +314,6 @@ as_profile_dump (AsProfile *profile)
 	}
 }
 
-/**
- * as_profile_autodump_cb:
- **/
 static gboolean
 as_profile_autodump_cb (gpointer user_data)
 {
@@ -354,9 +339,6 @@ as_profile_set_autodump (AsProfile *profile, guint delay)
 	profile->autodump_id = g_timeout_add (delay, as_profile_autodump_cb, profile);
 }
 
-/**
- * as_profile_finalize:
- **/
 static void
 as_profile_finalize (GObject *object)
 {
@@ -371,9 +353,6 @@ as_profile_finalize (GObject *object)
 	G_OBJECT_CLASS (as_profile_parent_class)->finalize (object);
 }
 
-/**
- * as_profile_class_init:
- **/
 static void
 as_profile_class_init (AsProfileClass *klass)
 {
@@ -381,9 +360,6 @@ as_profile_class_init (AsProfileClass *klass)
 	object_class->finalize = as_profile_finalize;
 }
 
-/**
- * as_profile_init:
- **/
 static void
 as_profile_init (AsProfile *profile)
 {
diff --git a/libappstream-glib/as-provide.c b/libappstream-glib/as-provide.c
index 8189973..fc1f43c 100644
--- a/libappstream-glib/as-provide.c
+++ b/libappstream-glib/as-provide.c
@@ -48,9 +48,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsProvide, as_provide, G_TYPE_OBJECT)
 
 #define GET_PRIVATE(o) (as_provide_get_instance_private (o))
 
-/**
- * as_provide_finalize:
- **/
 static void
 as_provide_finalize (GObject *object)
 {
@@ -62,17 +59,11 @@ as_provide_finalize (GObject *object)
 	G_OBJECT_CLASS (as_provide_parent_class)->finalize (object);
 }
 
-/**
- * as_provide_init:
- **/
 static void
 as_provide_init (AsProvide *provide)
 {
 }
 
-/**
- * as_provide_class_init:
- **/
 static void
 as_provide_class_init (AsProvideClass *klass)
 {
diff --git a/libappstream-glib/as-release.c b/libappstream-glib/as-release.c
index 1346f69..731daa1 100644
--- a/libappstream-glib/as-release.c
+++ b/libappstream-glib/as-release.c
@@ -63,9 +63,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsRelease, as_release, G_TYPE_OBJECT)
 
 #define GET_PRIVATE(o) (as_release_get_instance_private (o))
 
-/**
- * as_release_finalize:
- **/
 static void
 as_release_finalize (GObject *object)
 {
@@ -82,9 +79,6 @@ as_release_finalize (GObject *object)
 	G_OBJECT_CLASS (as_release_parent_class)->finalize (object);
 }
 
-/**
- * as_release_init:
- **/
 static void
 as_release_init (AsRelease *release)
 {
@@ -101,9 +95,6 @@ as_release_init (AsRelease *release)
 		priv->size[i] = 0;
 }
 
-/**
- * as_release_class_init:
- **/
 static void
 as_release_class_init (AsReleaseClass *klass)
 {
@@ -612,9 +603,6 @@ as_release_node_insert (AsRelease *release, GNode *parent, AsNodeContext *ctx)
 	return n;
 }
 
-/**
- * as_release_iso8601_to_datetime:
- **/
 static GDateTime *
 as_release_iso8601_to_datetime (const gchar *iso_date)
 {
diff --git a/libappstream-glib/as-screenshot.c b/libappstream-glib/as-screenshot.c
index 9be5061..18e4d7b 100644
--- a/libappstream-glib/as-screenshot.c
+++ b/libappstream-glib/as-screenshot.c
@@ -52,9 +52,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsScreenshot, as_screenshot, G_TYPE_OBJECT)
 
 #define GET_PRIVATE(o) (as_screenshot_get_instance_private (o))
 
-/**
- * as_screenshot_finalize:
- **/
 static void
 as_screenshot_finalize (GObject *object)
 {
@@ -67,9 +64,6 @@ as_screenshot_finalize (GObject *object)
 	G_OBJECT_CLASS (as_screenshot_parent_class)->finalize (object);
 }
 
-/**
- * as_screenshot_init:
- **/
 static void
 as_screenshot_init (AsScreenshot *screenshot)
 {
@@ -79,9 +73,6 @@ as_screenshot_init (AsScreenshot *screenshot)
 	priv->captions = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, g_free);
 }
 
-/**
- * as_screenshot_class_init:
- **/
 static void
 as_screenshot_class_init (AsScreenshotClass *klass)
 {
diff --git a/libappstream-glib/as-self-test.c b/libappstream-glib/as-self-test.c
index 2c3c20e..e368eaf 100644
--- a/libappstream-glib/as-self-test.c
+++ b/libappstream-glib/as-self-test.c
@@ -50,9 +50,6 @@
 
 #define AS_TEST_WILDCARD_SHA1	"\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?\?"
 
-/**
- * as_test_compare_lines:
- **/
 static gboolean
 as_test_compare_lines (const gchar *txt1, const gchar *txt2, GError **error)
 {
@@ -80,9 +77,6 @@ as_test_compare_lines (const gchar *txt1, const gchar *txt2, GError **error)
 	return FALSE;
 }
 
-/**
- * as_test_get_filename:
- **/
 static gchar *
 as_test_get_filename (const gchar *filename)
 {
@@ -109,9 +103,6 @@ as_test_hang_check_cb (gpointer user_data)
 	return G_SOURCE_REMOVE;
 }
 
-/**
- * as_test_loop_run_with_timeout:
- **/
 static void
 as_test_loop_run_with_timeout (guint timeout_ms)
 {
@@ -122,9 +113,6 @@ as_test_loop_run_with_timeout (guint timeout_ms)
 	g_main_loop_run (_test_loop);
 }
 
-/**
- * as_test_loop_quit:
- **/
 static void
 as_test_loop_quit (void)
 {
diff --git a/libappstream-glib/as-store-cab.c b/libappstream-glib/as-store-cab.c
index f918d11..cf5d8ff 100644
--- a/libappstream-glib/as-store-cab.c
+++ b/libappstream-glib/as-store-cab.c
@@ -32,9 +32,6 @@
 G_DEFINE_AUTOPTR_CLEANUP_FUNC(GCabCabinet, g_object_unref)
 #endif
 
-/**
- * as_store_cab_cb:
- **/
 static gboolean
 as_store_cab_cb (GCabFile *file, gpointer user_data)
 {
@@ -57,9 +54,6 @@ as_store_cab_cb (GCabFile *file, gpointer user_data)
 	return TRUE;
 }
 
-/**
- * as_store_cab_verify_checksum_cab:
- **/
 static gboolean
 as_store_cab_verify_checksum_cab (AsRelease *release,
 				  GBytes *bytes,
@@ -91,9 +85,6 @@ as_store_cab_verify_checksum_cab (AsRelease *release,
 	return TRUE;
 }
 
-/**
- * as_store_cab_verify_checksum_fw:
- **/
 static gboolean
 as_store_cab_verify_checksum_fw (AsChecksum *checksum,
 				 const gchar *tmp_path,
@@ -137,9 +128,6 @@ as_store_cab_verify_checksum_fw (AsChecksum *checksum,
 	return TRUE;
 }
 
-/**
- * as_store_cab_set_release_blobs:
- **/
 static gboolean
 as_store_cab_set_release_blobs (AsRelease *release, const gchar *tmp_path, GError **error)
 {
@@ -207,9 +195,6 @@ as_store_cab_set_release_blobs (AsRelease *release, const gchar *tmp_path, GErro
 	return TRUE;
 }
 
-/**
- * as_store_cab_from_bytes_with_origin:
- **/
 static gboolean
 as_store_cab_from_bytes_with_origin (AsStore *store,
 				     GBytes *bytes,
@@ -421,9 +406,6 @@ as_store_cab_from_bytes_with_origin (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_cab_from_bytes:
- **/
 gboolean
 as_store_cab_from_bytes (AsStore *store,
 			 GBytes *bytes,
@@ -434,9 +416,6 @@ as_store_cab_from_bytes (AsStore *store,
 						    cancellable, error);
 }
 
-/**
- * as_store_cab_from_file:
- **/
 gboolean
 as_store_cab_from_file (AsStore *store,
 			GFile *file,
diff --git a/libappstream-glib/as-store.c b/libappstream-glib/as-store.c
index e22683e..0e78c10 100644
--- a/libappstream-glib/as-store.c
+++ b/libappstream-glib/as-store.c
@@ -117,9 +117,6 @@ static gboolean	as_store_from_file_internal (AsStore *store,
 					     GCancellable *cancellable,
 					     GError **error);
 
-/**
- * as_store_finalize:
- **/
 static void
 as_store_finalize (GObject *object)
 {
@@ -141,9 +138,6 @@ as_store_finalize (GObject *object)
 	G_OBJECT_CLASS (as_store_parent_class)->finalize (object);
 }
 
-/**
- * as_store_class_init:
- **/
 static void
 as_store_class_init (AsStoreClass *klass)
 {
@@ -168,9 +162,6 @@ as_store_class_init (AsStoreClass *klass)
 	object_class->finalize = as_store_finalize;
 }
 
-/**
- * as_store_perhaps_emit_changed:
- */
 static void
 as_store_perhaps_emit_changed (AsStore *store, const gchar *details)
 {
@@ -188,9 +179,6 @@ as_store_perhaps_emit_changed (AsStore *store, const gchar *details)
 	priv->is_pending_changed_signal = FALSE;
 }
 
-/**
- * as_store_changed_inhibit:
- */
 static guint32 *
 as_store_changed_inhibit (AsStore *store)
 {
@@ -199,9 +187,6 @@ as_store_changed_inhibit (AsStore *store)
 	return &priv->changed_block_refcnt;
 }
 
-/**
- * as_store_changed_uninhibit:
- */
 static void
 as_store_changed_uninhibit (guint32 **tok)
 {
@@ -215,9 +200,6 @@ as_store_changed_uninhibit (guint32 **tok)
 	*tok = NULL;
 }
 
-/**
- * as_store_changed_uninhibit_cb:
- */
 static void
 as_store_changed_uninhibit_cb (void *v)
 {
@@ -322,9 +304,6 @@ as_store_remove_all (AsStore *store)
 	g_hash_table_remove_all (priv->hash_pkgname);
 }
 
-/**
- * as_store_regen_metadata_index_key:
- **/
 static void
 as_store_regen_metadata_index_key (AsStore *store, const gchar *key)
 {
@@ -675,9 +654,6 @@ as_store_get_app_by_id_with_fallbacks (AsStore *store, const gchar *id)
 	return NULL;
 }
 
-/**
- * as_app_has_pkgname:
- **/
 static gboolean
 as_app_has_pkgname (AsApp *app, const gchar *pkgname)
 {
@@ -937,9 +913,6 @@ as_store_add_app (AsStore *store, AsApp *app)
 	as_store_perhaps_emit_changed (store, "add-app");
 }
 
-/**
- * as_store_match_addons:
- **/
 static void
 as_store_match_addons (AsStore *store)
 {
@@ -975,9 +948,6 @@ as_store_match_addons (AsStore *store)
 	}
 }
 
-/**
- * as_store_get_origin_for_flatpak:
- **/
 static gchar *
 as_store_get_origin_for_flatpak (const gchar *fn)
 {
@@ -1014,9 +984,6 @@ as_store_fixup_id_prefix (AsApp *app, const gchar *id_prefix)
 	as_app_set_id (app, id);
 }
 
-/**
- * as_store_from_root:
- **/
 static gboolean
 as_store_from_root (AsStore *store,
 		    AsNode *root,
@@ -1213,9 +1180,6 @@ as_store_from_root (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_load_yaml_file:
- **/
 static gboolean
 as_store_load_yaml_file (AsStore *store,
 			 GFile *file,
@@ -1302,9 +1266,6 @@ as_store_load_yaml_file (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_rescan_flatpak_dir:
- */
 static void
 as_store_rescan_flatpak_dir (AsStore *store, const gchar *filename)
 {
@@ -1330,9 +1291,6 @@ as_store_rescan_flatpak_dir (AsStore *store, const gchar *filename)
 	}
 }
 
-/**
- * as_store_remove_by_source_file:
- */
 static void
 as_store_remove_by_source_file (AsStore *store, const gchar *filename)
 {
@@ -1366,9 +1324,6 @@ as_store_remove_by_source_file (AsStore *store, const gchar *filename)
 	as_store_perhaps_emit_changed (store, "remove-by-source-file");
 }
 
-/**
- * as_store_watch_source_added:
- */
 static void
 as_store_watch_source_added (AsStore *store, const gchar *filename)
 {
@@ -1401,9 +1356,6 @@ as_store_watch_source_added (AsStore *store, const gchar *filename)
 	}
 }
 
-/**
- * as_store_watch_source_changed:
- */
 static void
 as_store_watch_source_changed (AsStore *store, const gchar *filename)
 {
@@ -1413,9 +1365,6 @@ as_store_watch_source_changed (AsStore *store, const gchar *filename)
 	as_store_watch_source_added (store, filename);
 }
 
-/**
- * as_store_monitor_changed_cb:
- */
 static void
 as_store_monitor_changed_cb (AsMonitor *monitor,
 			     const gchar *filename,
@@ -1435,9 +1384,6 @@ as_store_monitor_changed_cb (AsMonitor *monitor,
 	as_store_perhaps_emit_changed (store, "file changed");
 }
 
-/**
- * as_store_monitor_added_cb:
- */
 static void
 as_store_monitor_added_cb (AsMonitor *monitor,
 			     const gchar *filename,
@@ -1457,9 +1403,6 @@ as_store_monitor_added_cb (AsMonitor *monitor,
 	as_store_perhaps_emit_changed (store, "file added");
 }
 
-/**
- * as_store_monitor_removed_cb:
- */
 static void
 as_store_monitor_removed_cb (AsMonitor *monitor,
 			     const gchar *filename,
@@ -1518,9 +1461,6 @@ as_store_add_path_data (AsStore *store,
 	g_hash_table_insert (priv->appinfo_dirs, g_strdup (path), path_data);
 }
 
-/**
- * as_store_from_file_internal:
- **/
 static gboolean
 as_store_from_file_internal (AsStore *store,
 			     GFile *file,
@@ -1721,9 +1661,6 @@ as_store_from_xml (AsStore *store,
 				   error);
 }
 
-/**
- * as_store_apps_sort_cb:
- **/
 static gint
 as_store_apps_sort_cb (gconstpointer a, gconstpointer b)
 {
@@ -1731,9 +1668,6 @@ as_store_apps_sort_cb (gconstpointer a, gconstpointer b)
 			  as_app_get_id (AS_APP (*(AsApp **) b)));
 }
 
-/**
- * as_store_check_app_for_veto:
- **/
 static void
 as_store_check_app_for_veto (AsApp *app)
 {
@@ -1754,9 +1688,6 @@ as_store_check_app_for_veto (AsApp *app)
 	}
 }
 
-/**
- * as_store_check_apps_for_veto:
- **/
 static void
 as_store_check_apps_for_veto (AsStore *store)
 {
@@ -2192,9 +2123,6 @@ as_store_set_watch_flags (AsStore *store, AsStoreWatchFlags watch_flags)
 	priv->watch_flags = watch_flags;
 }
 
-/**
- * as_store_guess_origin_fallback:
- */
 static gboolean
 as_store_guess_origin_fallback (AsStore *store,
 				const gchar *filename,
@@ -2226,9 +2154,6 @@ as_store_guess_origin_fallback (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_load_app_info_file:
- */
 static gboolean
 as_store_load_app_info_file (AsStore *store,
 			     const gchar *id_prefix,
@@ -2257,9 +2182,6 @@ as_store_load_app_info_file (AsStore *store,
 					    error);
 }
 
-/**
- * as_store_load_app_info:
- **/
 static gboolean
 as_store_load_app_info (AsStore *store,
 			const gchar *id_prefix,
@@ -2338,9 +2260,6 @@ as_store_load_app_info (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_set_app_installed:
- **/
 static void
 as_store_set_app_installed (AsApp *app)
 {
@@ -2359,9 +2278,6 @@ as_store_set_app_installed (AsApp *app)
 	as_app_set_state (app, AS_APP_STATE_INSTALLED);
 }
 
-/**
- * as_store_load_installed_file_is_valid:
- **/
 static gboolean
 as_store_load_installed_file_is_valid (const gchar *filename)
 {
@@ -2375,9 +2291,6 @@ as_store_load_installed_file_is_valid (const gchar *filename)
 	return FALSE;
 }
 
-/**
- * as_store_load_installed:
- **/
 static gboolean
 as_store_load_installed (AsStore *store,
 			 AsStoreLoadFlags flags,
@@ -2492,9 +2405,6 @@ as_store_load_path (AsStore *store, const gchar *path,
 					NULL, path, cancellable, error);
 }
 
-/**
- * as_store_search_installed:
- **/
 static gboolean
 as_store_search_installed (AsStore *store,
 			   AsStoreLoadFlags flags,
@@ -2513,9 +2423,6 @@ as_store_search_installed (AsStore *store,
 					dest, cancellable, error);
 }
 
-/**
- * as_store_search_app_info:
- **/
 static gboolean
 as_store_search_app_info (AsStore *store,
 			  AsStoreLoadFlags flags,
@@ -2543,9 +2450,6 @@ as_store_search_app_info (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_monitor_flatpak_dir:
- **/
 static void
 as_store_monitor_flatpak_dir (AsStore *store,
 			      const gchar *path,
@@ -2564,9 +2468,6 @@ as_store_monitor_flatpak_dir (AsStore *store,
 	}
 }
 
-/**
- * as_store_search_flatpak_arch:
- **/
 static gboolean
 as_store_search_flatpak_arch (AsStore *store,
 			      AsStoreLoadFlags flags,
@@ -2595,9 +2496,6 @@ as_store_search_flatpak_arch (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_search_flatpaks:
- **/
 static gboolean
 as_store_search_flatpaks (AsStore *store,
 			  AsStoreLoadFlags flags,
@@ -2625,9 +2523,6 @@ as_store_search_flatpaks (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_search_per_system:
- **/
 static gboolean
 as_store_search_per_system (AsStore *store,
 			    AsStoreLoadFlags flags,
@@ -2756,9 +2651,6 @@ as_store_search_per_system (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_search_per_user:
- **/
 static gboolean
 as_store_search_per_user (AsStore *store,
 			  AsStoreLoadFlags flags,
@@ -2905,9 +2797,6 @@ as_store_load (AsStore *store,
 	return TRUE;
 }
 
-/**
- * as_store_validate_add:
- */
 G_GNUC_PRINTF (3, 4) static void
 as_store_validate_add (GPtrArray *problems, AsProblemKind kind, const gchar *fmt, ...)
 {
@@ -2934,9 +2823,6 @@ as_store_validate_add (GPtrArray *problems, AsProblemKind kind, const gchar *fmt
 	g_ptr_array_add (problems, problem);
 }
 
-/**
- * as_store_get_unique_name_app_key:
- */
 static gchar *
 as_store_get_unique_name_app_key (AsApp *app)
 {
@@ -3191,9 +3077,6 @@ as_store_validate (AsStore *store, AsAppValidateFlags flags, GError **error)
 	return probs;
 }
 
-/**
- * as_store_path_data_free:
- **/
 static void
 as_store_path_data_free (AsStorePathData *path_data)
 {
@@ -3202,9 +3085,6 @@ as_store_path_data_free (AsStorePathData *path_data)
 	g_slice_free (AsStorePathData, path_data);
 }
 
-/**
- * as_store_init:
- **/
 static void
 as_store_init (AsStore *store)
 {
diff --git a/libappstream-glib/as-translation.c b/libappstream-glib/as-translation.c
index 9a19d56..a50c486 100644
--- a/libappstream-glib/as-translation.c
+++ b/libappstream-glib/as-translation.c
@@ -50,9 +50,6 @@ G_DEFINE_TYPE_WITH_PRIVATE (AsTranslation, as_translation, G_TYPE_OBJECT)
 
 #define GET_PRIVATE(o) (as_translation_get_instance_private (o))
 
-/**
- * as_translation_finalize:
- **/
 static void
 as_translation_finalize (GObject *object)
 {
@@ -64,17 +61,11 @@ as_translation_finalize (GObject *object)
 	G_OBJECT_CLASS (as_translation_parent_class)->finalize (object);
 }
 
-/**
- * as_translation_init:
- **/
 static void
 as_translation_init (AsTranslation *translation)
 {
 }
 
-/**
- * as_translation_class_init:
- **/
 static void
 as_translation_class_init (AsTranslationClass *klass)
 {
diff --git a/libappstream-glib/as-utils.c b/libappstream-glib/as-utils.c
index f1588e9..ca28bc3 100644
--- a/libappstream-glib/as-utils.c
+++ b/libappstream-glib/as-utils.c
@@ -95,9 +95,6 @@ as_hash_lookup_by_locale (GHashTable *hash, const gchar *locale)
 	return NULL;
 }
 
-/**
- * as_utils_locale_to_language:
- **/
 static gchar *
 as_utils_locale_to_language (const gchar *locale)
 {
@@ -631,9 +628,6 @@ as_utils_license_to_spdx (const gchar *license)
 	return g_string_free (str, FALSE);
 }
 
-/**
- * as_pixbuf_blur_private:
- **/
 static void
 as_pixbuf_blur_private (GdkPixbuf *src, GdkPixbuf *dest, gint radius, guchar *div_kernel_size)
 {
@@ -996,9 +990,6 @@ as_utils_find_icon_filename (const gchar *destdir,
 						 error);
 }
 
-/**
- * as_utils_location_get_prefix:
- **/
 static const gchar *
 as_utils_location_get_prefix (AsUtilsLocation location)
 {
@@ -1011,9 +1002,6 @@ as_utils_location_get_prefix (AsUtilsLocation location)
 	return NULL;
 }
 
-/**
- * as_utils_install_icon:
- **/
 static gboolean
 as_utils_install_icon (AsUtilsLocation location,
 		       const gchar *filename,
@@ -1117,9 +1105,6 @@ out:
 	return ret;
 }
 
-/**
- * as_utils_install_xml:
- **/
 static gboolean
 as_utils_install_xml (const gchar *filename,
 		      const gchar *origin,
diff --git a/libappstream-glib/as-yaml.c b/libappstream-glib/as-yaml.c
index c9b95fe..8aed749 100644
--- a/libappstream-glib/as-yaml.c
+++ b/libappstream-glib/as-yaml.c
@@ -43,9 +43,6 @@ typedef struct {
 	AsYamlNodeKind	 kind;
 } AsYamlNode;
 
-/**
- * as_yaml_node_get_key:
- **/
 const gchar *
 as_yaml_node_get_key (const AsNode *node)
 {
@@ -60,9 +57,6 @@ as_yaml_node_get_key (const AsNode *node)
 	return ym->key;
 }
 
-/**
- * as_yaml_node_get_value:
- **/
 const gchar *
 as_yaml_node_get_value (const AsNode *node)
 {
@@ -77,9 +71,6 @@ as_yaml_node_get_value (const AsNode *node)
 	return ym->value;
 }
 
-/**
- * as_yaml_node_get_value_as_int:
- **/
 gint
 as_yaml_node_get_value_as_int (const AsNode *node)
 {
@@ -98,9 +89,6 @@ as_yaml_node_get_value_as_int (const AsNode *node)
 	return value_tmp;
 }
 
-/**
- * as_node_yaml_destroy_node_cb:
- **/
 static gboolean
 as_node_yaml_destroy_node_cb (AsNode *node, gpointer data)
 {
@@ -113,9 +101,6 @@ as_node_yaml_destroy_node_cb (AsNode *node, gpointer data)
 	return FALSE;
 }
 
-/**
- * as_yaml_unref:
- **/
 void
 as_yaml_unref (AsNode *node)
 {
@@ -124,9 +109,6 @@ as_yaml_unref (AsNode *node)
 	g_node_destroy (node);
 }
 
-/**
- * as_yaml_to_string_cb:
- **/
 static gboolean
 as_yaml_to_string_cb (AsNode *node, gpointer data)
 {
@@ -167,9 +149,6 @@ as_yaml_to_string_cb (AsNode *node, gpointer data)
 	return FALSE;
 }
 
-/**
- * as_yaml_to_string:
- **/
 GString *
 as_yaml_to_string (AsNode *node)
 {
@@ -180,9 +159,6 @@ as_yaml_to_string (AsNode *node)
 }
 
 #if AS_BUILD_DEP11
-/**
- * as_yaml_node_get_kind:
- **/
 static AsYamlNodeKind
 as_yaml_node_get_kind (AsNode *node)
 {
@@ -195,9 +171,6 @@ as_yaml_node_get_kind (AsNode *node)
 	return ym->kind;
 }
 
-/**
- * as_yaml_node_new:
- **/
 static AsYamlNode *
 as_yaml_node_new (AsYamlNodeKind kind, const gchar *id)
 {
@@ -208,9 +181,6 @@ as_yaml_node_new (AsYamlNodeKind kind, const gchar *id)
 	return ym;
 }
 
-/**
- * as_node_yaml_process_layer:
- **/
 static void
 as_node_yaml_process_layer (yaml_parser_t *parser, AsNode *parent)
 {
@@ -276,9 +246,6 @@ as_node_yaml_process_layer (yaml_parser_t *parser, AsNode *parent)
 }
 #endif
 
-/**
- * as_yaml_from_data:
- **/
 AsNode *
 as_yaml_from_data (const gchar *data, gssize data_len, GError **error)
 {
@@ -304,9 +271,6 @@ as_yaml_from_data (const gchar *data, gssize data_len, GError **error)
 }
 
 #if AS_BUILD_DEP11
-/**
- * as_yaml_read_handler_cb:
- **/
 static int
 as_yaml_read_handler_cb (void *data,
 			 unsigned char *buffer,
@@ -319,9 +283,6 @@ as_yaml_read_handler_cb (void *data,
 }
 #endif
 
-/**
- * as_yaml_from_file:
- **/
 AsNode *
 as_yaml_from_file (GFile *file, GCancellable *cancellable, GError **error)
 {