[gnome-software] trivial: Do not use gtk-doc headers in the plugins



commit 5697380f836bd9ce2a10ad7b970dd5d788b2e23d
Author: Richard Hughes <richard hughsie com>
Date:   Mon May 23 13:55:36 2016 +0100

    trivial: Do not use gtk-doc headers in the plugins
    
    It serves no purpose, and with a proper symbol browser it's not required.

 src/plugins/gs-appstream.c                     |   31 +-------
 src/plugins/gs-markdown.c                      |   89 +--------------------
 src/plugins/gs-plugin-appstream.c              |   52 +-----------
 src/plugins/gs-plugin-dpkg.c                   |    6 --
 src/plugins/gs-plugin-dummy.c                  |   69 ---------------
 src/plugins/gs-plugin-epiphany.c               |   21 -----
 src/plugins/gs-plugin-fedora-distro-upgrades.c |   21 -----
 src/plugins/gs-plugin-fedora-tagger-usage.c    |   15 ----
 src/plugins/gs-plugin-flatpak.c                |  106 ------------------------
 src/plugins/gs-plugin-fwupd.c                  |   58 -------------
 src/plugins/gs-plugin-hardcoded-blacklist.c    |    6 --
 src/plugins/gs-plugin-icons.c                  |   21 -----
 src/plugins/gs-plugin-key-colors.c             |   15 ----
 src/plugins/gs-plugin-limba.c                  |   44 +----------
 src/plugins/gs-plugin-menu-spec-categories.c   |    3 -
 src/plugins/gs-plugin-menu-spec-refine.c       |    9 --
 src/plugins/gs-plugin-odrs.c                   |   69 ---------------
 src/plugins/gs-plugin-ostree.c                 |   15 ----
 src/plugins/gs-plugin-packagekit-history.c     |   15 ----
 src/plugins/gs-plugin-packagekit-local.c       |   17 +----
 src/plugins/gs-plugin-packagekit-offline.c     |    6 --
 src/plugins/gs-plugin-packagekit-origin.c      |   12 ---
 src/plugins/gs-plugin-packagekit-proxy.c       |   12 ---
 src/plugins/gs-plugin-packagekit-refine.c      |   61 +-------------
 src/plugins/gs-plugin-packagekit-refresh.c     |   12 ---
 src/plugins/gs-plugin-packagekit-upgrade.c     |   12 ---
 src/plugins/gs-plugin-packagekit.c             |   42 ---------
 src/plugins/gs-plugin-provenance-license.c     |   18 ----
 src/plugins/gs-plugin-provenance.c             |   15 ----
 src/plugins/gs-plugin-rpm.c                    |    6 --
 src/plugins/gs-plugin-shell-extensions.c       |   51 -----------
 src/plugins/gs-plugin-steam.c                  |   65 +--------------
 src/plugins/gs-plugin-systemd-updates.c        |   24 ------
 src/plugins/gs-plugin-xdg-app.c                |  102 -----------------------
 src/plugins/menu-spec-common.c                 |    3 -
 src/plugins/packagekit-common.c                |   12 ---
 36 files changed, 8 insertions(+), 1127 deletions(-)
---
diff --git a/src/plugins/gs-appstream.c b/src/plugins/gs-appstream.c
index 896e155..b6411b8 100644
--- a/src/plugins/gs-appstream.c
+++ b/src/plugins/gs-appstream.c
@@ -27,9 +27,6 @@
 
 #define        GS_APPSTREAM_MAX_SCREENSHOTS    5
 
-/**
- * gs_refine_item_pixbuf:
- */
 static void
 gs_refine_item_pixbuf (GsPlugin *plugin, GsApp *app, AsApp *item)
 {
@@ -83,9 +80,6 @@ gs_refine_item_pixbuf (GsPlugin *plugin, GsApp *app, AsApp *item)
        }
 }
 
-/**
- * gs_appstream_refine_add_addons:
- */
 static void
 gs_appstream_refine_add_addons (GsPlugin *plugin, GsApp *app, AsApp *item)
 {
@@ -111,9 +105,7 @@ gs_appstream_refine_add_addons (GsPlugin *plugin, GsApp *app, AsApp *item)
                gs_app_add_addon (app, addon);
        }
 }
-/**
- * gs_appstream_refine_add_screenshots:
- */
+
 static void
 gs_appstream_refine_add_screenshots (GsApp *app, AsApp *item)
 {
@@ -145,9 +137,6 @@ gs_appstream_refine_add_screenshots (GsApp *app, AsApp *item)
        }
 }
 
-/**
- * gs_appstream_is_recent_release:
- */
 static gboolean
 gs_appstream_is_recent_release (AsApp *app)
 {
@@ -167,9 +156,6 @@ gs_appstream_is_recent_release (AsApp *app)
        return secs / (60 * 60 * 24) < 365;
 }
 
-/**
- * gs_appstream_are_screenshots_perfect:
- */
 static gboolean
 gs_appstream_are_screenshots_perfect (AsApp *app)
 {
@@ -209,9 +195,6 @@ gs_appstream_are_screenshots_perfect (AsApp *app)
        return TRUE;
 }
 
-/**
- * gs_appstream_copy_metadata:
- */
 static void
 gs_appstream_copy_metadata (GsApp *app, AsApp *item)
 {
@@ -230,9 +213,6 @@ gs_appstream_copy_metadata (GsApp *app, AsApp *item)
        }
 }
 
-/**
- * gs_appstream_create_runtime:
- */
 GsApp *
 gs_appstream_create_runtime (GsApp *parent, const gchar *runtime)
 {
@@ -271,9 +251,6 @@ gs_appstream_create_runtime (GsApp *parent, const gchar *runtime)
        return g_steal_pointer (&app);
 }
 
-/**
- * gs_refine_item_management_plugin:
- */
 static void
 gs_refine_item_management_plugin (GsApp *app, AsApp *item)
 {
@@ -316,9 +293,6 @@ gs_refine_item_management_plugin (GsApp *app, AsApp *item)
        }
 }
 
-/**
- * gs_appstream_refine_app_updates:
- */
 static gboolean
 gs_appstream_refine_app_updates (GsPlugin *plugin,
                                 GsApp *app,
@@ -399,9 +373,6 @@ gs_appstream_refine_app_updates (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_appstream_refine_app:
- */
 gboolean
 gs_appstream_refine_app (GsPlugin *plugin,
                         GsApp *app,
diff --git a/src/plugins/gs-markdown.c b/src/plugins/gs-markdown.c
index 3146822..22cddc9 100644
--- a/src/plugins/gs-markdown.c
+++ b/src/plugins/gs-markdown.c
@@ -91,7 +91,7 @@ struct _GsMarkdown {
 
 G_DEFINE_TYPE (GsMarkdown, gs_markdown, G_TYPE_OBJECT)
 
-/**
+/*
  * gs_markdown_to_text_line_is_rule:
  *
  * Horizontal rules are created by placing three or more hyphens, asterisks,
@@ -126,9 +126,6 @@ gs_markdown_to_text_line_is_rule (const gchar *line)
        return FALSE;
 }
 
-/**
- * gs_markdown_to_text_line_is_bullet:
- **/
 static gboolean
 gs_markdown_to_text_line_is_bullet (const gchar *line)
 {
@@ -140,36 +137,24 @@ gs_markdown_to_text_line_is_bullet (const gchar *line)
                g_str_has_prefix (line, " + "));
 }
 
-/**
- * gs_markdown_to_text_line_is_header1:
- **/
 static gboolean
 gs_markdown_to_text_line_is_header1 (const gchar *line)
 {
        return g_str_has_prefix (line, "# ");
 }
 
-/**
- * gs_markdown_to_text_line_is_header2:
- **/
 static gboolean
 gs_markdown_to_text_line_is_header2 (const gchar *line)
 {
        return g_str_has_prefix (line, "## ");
 }
 
-/**
- * gs_markdown_to_text_line_is_header1_type2:
- **/
 static gboolean
 gs_markdown_to_text_line_is_header1_type2 (const gchar *line)
 {
        return g_str_has_prefix (line, "===");
 }
 
-/**
- * gs_markdown_to_text_line_is_header2_type2:
- **/
 static gboolean
 gs_markdown_to_text_line_is_header2_type2 (const gchar *line)
 {
@@ -177,9 +162,6 @@ gs_markdown_to_text_line_is_header2_type2 (const gchar *line)
 }
 
 #if 0
-/**
- * gs_markdown_to_text_line_is_code:
- **/
 static gboolean
 gs_markdown_to_text_line_is_code (const gchar *line)
 {
@@ -187,9 +169,6 @@ gs_markdown_to_text_line_is_code (const gchar *line)
                g_str_has_prefix (line, "\t"));
 }
 
-/**
- * gs_markdown_to_text_line_is_blockquote:
- **/
 static gboolean
 gs_markdown_to_text_line_is_blockquote (const gchar *line)
 {
@@ -197,9 +176,6 @@ gs_markdown_to_text_line_is_blockquote (const gchar *line)
 }
 #endif
 
-/**
- * gs_markdown_to_text_line_is_blank:
- **/
 static gboolean
 gs_markdown_to_text_line_is_blank (const gchar *line)
 {
@@ -221,9 +197,6 @@ gs_markdown_to_text_line_is_blank (const gchar *line)
        return TRUE;
 }
 
-/**
- * gs_markdown_replace:
- **/
 static gchar *
 gs_markdown_replace (const gchar *haystack,
                     const gchar *needle,
@@ -234,9 +207,6 @@ gs_markdown_replace (const gchar *haystack,
        return g_strjoinv (replace, split);
 }
 
-/**
- * gs_markdown_strstr_spaces:
- **/
 static gchar *
 gs_markdown_strstr_spaces (const gchar *haystack, const gchar *needle)
 {
@@ -261,9 +231,6 @@ retry:
        return found;
 }
 
-/**
- * gs_markdown_to_text_line_formatter:
- **/
 static gchar *
 gs_markdown_to_text_line_formatter (const gchar *line,
                                    const gchar *formatter,
@@ -309,9 +276,6 @@ gs_markdown_to_text_line_formatter (const gchar *line,
        return g_strdup (line);
 }
 
-/**
- * gs_markdown_to_text_line_format_sections:
- **/
 static gchar *
 gs_markdown_to_text_line_format_sections (GsMarkdown *self, const gchar *line)
 {
@@ -365,9 +329,6 @@ gs_markdown_to_text_line_format_sections (GsMarkdown *self, const gchar *line)
        return data;
 }
 
-/**
- * gs_markdown_to_text_line_format:
- **/
 static gchar *
 gs_markdown_to_text_line_format (GsMarkdown *self, const gchar *line)
 {
@@ -402,9 +363,6 @@ gs_markdown_to_text_line_format (GsMarkdown *self, const gchar *line)
        return g_string_free (string, FALSE);
 }
 
-/**
- * gs_markdown_add_pending:
- **/
 static gboolean
 gs_markdown_add_pending (GsMarkdown *self, const gchar *line)
 {
@@ -424,9 +382,6 @@ gs_markdown_add_pending (GsMarkdown *self, const gchar *line)
        return TRUE;
 }
 
-/**
- * gs_markdown_add_pending_header:
- **/
 static gboolean
 gs_markdown_add_pending_header (GsMarkdown *self, const gchar *line)
 {
@@ -438,9 +393,6 @@ gs_markdown_add_pending_header (GsMarkdown *self, const gchar *line)
        return gs_markdown_add_pending (self, copy);
 }
 
-/**
- * gs_markdown_count_chars_in_word:
- **/
 static guint
 gs_markdown_count_chars_in_word (const gchar *text, gchar find)
 {
@@ -461,9 +413,6 @@ gs_markdown_count_chars_in_word (const gchar *text, gchar find)
        return count;
 }
 
-/**
- * gs_markdown_word_is_code:
- **/
 static gboolean
 gs_markdown_word_is_code (const gchar *text)
 {
@@ -504,9 +453,6 @@ gs_markdown_word_is_code (const gchar *text)
        return FALSE;
 }
 
-/**
- * gs_markdown_word_auto_format_code:
- **/
 static gchar *
 gs_markdown_word_auto_format_code (const gchar *text)
 {
@@ -536,9 +482,6 @@ gs_markdown_word_auto_format_code (const gchar *text)
        return g_strjoinv (" ", words);
 }
 
-/**
- * gs_markdown_word_is_url:
- **/
 static gboolean
 gs_markdown_word_is_url (const gchar *text)
 {
@@ -551,9 +494,6 @@ gs_markdown_word_is_url (const gchar *text)
        return FALSE;
 }
 
-/**
- * gs_markdown_word_auto_format_urls:
- **/
 static gchar *
 gs_markdown_word_auto_format_urls (const gchar *text)
 {
@@ -584,9 +524,6 @@ gs_markdown_word_auto_format_urls (const gchar *text)
        return g_strjoinv (" ", words);
 }
 
-/**
- * gs_markdown_flush_pending:
- **/
 static void
 gs_markdown_flush_pending (GsMarkdown *self)
 {
@@ -663,9 +600,6 @@ gs_markdown_flush_pending (GsMarkdown *self)
        g_string_truncate (self->pending, 0);
 }
 
-/**
- * gs_markdown_to_text_line_process:
- **/
 static gboolean
 gs_markdown_to_text_line_process (GsMarkdown *self, const gchar *line)
 {
@@ -750,9 +684,6 @@ out:
        return ret;
 }
 
-/**
- * gs_markdown_set_output_kind:
- **/
 static void
 gs_markdown_set_output_kind (GsMarkdown *self, GsMarkdownOutputKind output)
 {
@@ -820,9 +751,6 @@ gs_markdown_set_output_kind (GsMarkdown *self, GsMarkdownOutputKind output)
        }
 }
 
-/**
- * gs_markdown_set_max_lines:
- **/
 void
 gs_markdown_set_max_lines (GsMarkdown *self, gint max_lines)
 {
@@ -830,9 +758,6 @@ gs_markdown_set_max_lines (GsMarkdown *self, gint max_lines)
        self->max_lines = max_lines;
 }
 
-/**
- * gs_markdown_set_smart_quoting:
- **/
 void
 gs_markdown_set_smart_quoting (GsMarkdown *self, gboolean smart_quoting)
 {
@@ -840,9 +765,6 @@ gs_markdown_set_smart_quoting (GsMarkdown *self, gboolean smart_quoting)
        self->smart_quoting = smart_quoting;
 }
 
-/**
- * gs_markdown_set_escape:
- **/
 void
 gs_markdown_set_escape (GsMarkdown *self, gboolean escape)
 {
@@ -850,9 +772,6 @@ gs_markdown_set_escape (GsMarkdown *self, gboolean escape)
        self->escape = escape;
 }
 
-/**
- * gs_markdown_set_autocode:
- **/
 void
 gs_markdown_set_autocode (GsMarkdown *self, gboolean autocode)
 {
@@ -860,9 +779,6 @@ gs_markdown_set_autocode (GsMarkdown *self, gboolean autocode)
        self->autocode = autocode;
 }
 
-/**
- * gs_markdown_set_autolinkify:
- **/
 void
 gs_markdown_set_autolinkify (GsMarkdown *self, gboolean autolinkify)
 {
@@ -870,9 +786,6 @@ gs_markdown_set_autolinkify (GsMarkdown *self, gboolean autolinkify)
        self->autolinkify = autolinkify;
 }
 
-/**
- * gs_markdown_parse:
- **/
 gchar *
 gs_markdown_parse (GsMarkdown *self, const gchar *markdown)
 {
diff --git a/src/plugins/gs-plugin-appstream.c b/src/plugins/gs-plugin-appstream.c
index 00a9baa..07cb738 100644
--- a/src/plugins/gs-plugin-appstream.c
+++ b/src/plugins/gs-plugin-appstream.c
@@ -40,9 +40,6 @@ struct GsPluginData {
        AsStore                 *store;
 };
 
-/**
- * gs_plugin_appstream_store_changed_cb:
- */
 static void
 gs_plugin_appstream_store_changed_cb (AsStore *store, GsPlugin *plugin)
 {
@@ -54,9 +51,6 @@ gs_plugin_appstream_store_changed_cb (AsStore *store, GsPlugin *plugin)
                gs_plugin_updates_changed (plugin);
 }
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -71,9 +65,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "dpkg");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -81,9 +72,7 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_object_unref (priv->store);
 }
 
-/**
- * gs_plugin_appstream_get_origins_hash:
- *
+/*
  * Returns: A hash table with a string key of the application origin and a
  * value of the guint percentage of the store is made up by that origin.
  */
@@ -128,9 +117,6 @@ gs_plugin_appstream_get_origins_hash (GPtrArray *array)
        return origins;
 }
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -227,9 +213,6 @@ gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_from_id:
- */
 static gboolean
 gs_plugin_refine_from_id (GsPlugin *plugin,
                          GsApp *app,
@@ -288,9 +271,6 @@ gs_plugin_refine_from_id (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_from_pkgname:
- */
 static gboolean
 gs_plugin_refine_from_pkgname (GsPlugin *plugin,
                               GsApp *app,
@@ -320,9 +300,6 @@ gs_plugin_refine_from_pkgname (GsPlugin *plugin,
        return gs_appstream_refine_app (plugin, app, item, error);
 }
 
-/**
- * gs_plugin_add_distro_upgrades:
- */
 gboolean
 gs_plugin_add_distro_upgrades (GsPlugin *plugin,
                               GsAppList *list,
@@ -353,9 +330,6 @@ gs_plugin_add_distro_upgrades (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
@@ -377,9 +351,6 @@ gs_plugin_refine_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_category_apps:
- */
 gboolean
 gs_plugin_add_category_apps (GsPlugin *plugin,
                             GsCategory *category,
@@ -432,9 +403,6 @@ gs_plugin_add_category_apps (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_search_item:
- */
 static gboolean
 gs_plugin_add_search_item (GsPlugin *plugin,
                           GsAppList *list,
@@ -470,9 +438,6 @@ gs_plugin_add_search_item (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_search:
- */
 gboolean
 gs_plugin_add_search (GsPlugin *plugin,
                      gchar **values,
@@ -503,9 +468,6 @@ gs_plugin_add_search (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_installed:
- */
 gboolean
 gs_plugin_add_installed (GsPlugin *plugin,
                         GsAppList *list,
@@ -535,9 +497,6 @@ gs_plugin_add_installed (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_categories_for_app:
- */
 static void
 gs_plugin_add_categories_for_app (GPtrArray *list, AsApp *app)
 {
@@ -580,9 +539,6 @@ gs_plugin_add_categories_for_app (GPtrArray *list, AsApp *app)
        }
 }
 
-/**
- * gs_plugin_add_categories:
- */
 gboolean
 gs_plugin_add_categories (GsPlugin *plugin,
                          GPtrArray *list,
@@ -610,9 +566,6 @@ gs_plugin_add_categories (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_popular:
- */
 gboolean
 gs_plugin_add_popular (GsPlugin *plugin,
                       GsAppList *list,
@@ -643,9 +596,6 @@ gs_plugin_add_popular (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_featured:
- */
 gboolean
 gs_plugin_add_featured (GsPlugin *plugin,
                        GsAppList *list,
diff --git a/src/plugins/gs-plugin-dpkg.c b/src/plugins/gs-plugin-dpkg.c
index 0e38390..9ebdd04 100644
--- a/src/plugins/gs-plugin-dpkg.c
+++ b/src/plugins/gs-plugin-dpkg.c
@@ -26,9 +26,6 @@
 
 #define DPKG_DEB_BINARY                "/usr/bin/dpkg-deb"
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -39,9 +36,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        }
 }
 
-/**
- * gs_plugin_file_to_app:
- */
 gboolean
 gs_plugin_file_to_app (GsPlugin *plugin,
                       GsAppList *list,
diff --git a/src/plugins/gs-plugin-dummy.c b/src/plugins/gs-plugin-dummy.c
index 0fa8cd6..d3be326 100644
--- a/src/plugins/gs-plugin-dummy.c
+++ b/src/plugins/gs-plugin-dummy.c
@@ -32,9 +32,6 @@ struct GsPluginData {
        guint                    quirk_id;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -49,9 +46,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "appstream");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -60,9 +54,6 @@ gs_plugin_destroy (GsPlugin *plugin)
                g_source_remove (priv->quirk_id);
 }
 
-/**
- * gs_plugin_adopt_app:
- */
 void
 gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
 {
@@ -74,9 +65,6 @@ gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
                gs_app_set_management_plugin (app, gs_plugin_get_name (plugin));
 }
 
-/**
- * gs_plugin_dummy_delay:
- */
 static gboolean
 gs_plugin_dummy_delay (GsPlugin *plugin,
                       GsApp *app,
@@ -103,9 +91,6 @@ gs_plugin_dummy_delay (GsPlugin *plugin,
        return ret;
 }
 
-/**
- * gs_plugin_dummy_poll_cb:
- */
 static gboolean
 gs_plugin_dummy_poll_cb (gpointer user_data)
 {
@@ -133,9 +118,6 @@ gs_plugin_dummy_poll_cb (gpointer user_data)
        return TRUE;
 }
 
-/**
- * gs_plugin_add_search:
- */
 gboolean
 gs_plugin_add_search (GsPlugin *plugin,
                      gchar **values,
@@ -186,9 +168,6 @@ gs_plugin_add_search (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_updates:
- */
 gboolean
 gs_plugin_add_updates (GsPlugin *plugin,
                       GsAppList *list,
@@ -254,9 +233,6 @@ gs_plugin_add_updates (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_installed:
- */
 gboolean
 gs_plugin_add_installed (GsPlugin *plugin,
                         GsAppList *list,
@@ -290,9 +266,6 @@ gs_plugin_add_installed (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_remove:
- */
 gboolean
 gs_plugin_app_remove (GsPlugin *plugin,
                      GsApp *app,
@@ -316,9 +289,6 @@ gs_plugin_app_remove (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_install:
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin,
                       GsApp *app,
@@ -342,9 +312,6 @@ gs_plugin_app_install (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_update_app:
- */
 gboolean
 gs_plugin_update_app (GsPlugin *plugin,
                      GsApp *app,
@@ -364,9 +331,6 @@ gs_plugin_update_app (GsPlugin *plugin,
        return FALSE;
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
@@ -458,9 +422,6 @@ gs_plugin_refine_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_category_apps:
- */
 gboolean
 gs_plugin_add_category_apps (GsPlugin *plugin,
                             GsCategory *category,
@@ -481,9 +442,6 @@ gs_plugin_add_category_apps (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_distro_upgrades:
- */
 gboolean
 gs_plugin_add_distro_upgrades (GsPlugin *plugin,
                               GsAppList *list,
@@ -529,9 +487,6 @@ gs_plugin_add_distro_upgrades (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
@@ -552,9 +507,6 @@ gs_plugin_refresh (GsPlugin *plugin,
        return gs_plugin_dummy_delay (plugin, app, delay_ms, cancellable, error);
 }
 
-/**
- * gs_plugin_app_upgrade_download:
- */
 gboolean
 gs_plugin_app_upgrade_download (GsPlugin *plugin, GsApp *app,
                                GCancellable *cancellable, GError **error)
@@ -574,9 +526,6 @@ gs_plugin_app_upgrade_download (GsPlugin *plugin, GsApp *app,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_upgrade_trigger:
- */
 gboolean
 gs_plugin_app_upgrade_trigger (GsPlugin *plugin, GsApp *app,
                               GCancellable *cancellable, GError **error)
@@ -590,9 +539,6 @@ gs_plugin_app_upgrade_trigger (GsPlugin *plugin, GsApp *app,
        return TRUE;
 }
 
-/**
- * gs_plugin_update_cancel:
- */
 gboolean
 gs_plugin_update_cancel (GsPlugin *plugin, GsApp *app,
                         GCancellable *cancellable, GError **error)
@@ -600,9 +546,6 @@ gs_plugin_update_cancel (GsPlugin *plugin, GsApp *app,
        return TRUE;
 }
 
-/**
- * gs_plugin_review_submit:
- */
 gboolean
 gs_plugin_review_submit (GsPlugin *plugin,
                         GsApp *app,
@@ -614,9 +557,6 @@ gs_plugin_review_submit (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_review_report:
- */
 gboolean
 gs_plugin_review_report (GsPlugin *plugin,
                         GsApp *app,
@@ -629,9 +569,6 @@ gs_plugin_review_report (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_review_upvote:
- */
 gboolean
 gs_plugin_review_upvote (GsPlugin *plugin,
                         GsApp *app,
@@ -644,9 +581,6 @@ gs_plugin_review_upvote (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_review_downvote:
- */
 gboolean
 gs_plugin_review_downvote (GsPlugin *plugin,
                           GsApp *app,
@@ -659,9 +593,6 @@ gs_plugin_review_downvote (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_review_remove:
- */
 gboolean
 gs_plugin_review_remove (GsPlugin *plugin,
                         GsApp *app,
diff --git a/src/plugins/gs-plugin-epiphany.c b/src/plugins/gs-plugin-epiphany.c
index ea65916..0e3a473 100644
--- a/src/plugins/gs-plugin-epiphany.c
+++ b/src/plugins/gs-plugin-epiphany.c
@@ -33,9 +33,6 @@
  * If the epiphany binary is not present then it self-disables.
  */
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -53,9 +50,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "appstream");
 }
 
-/**
- * gs_plugin_adopt_app:
- */
 void
 gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
 {
@@ -63,9 +57,6 @@ gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
                gs_app_set_management_plugin (app, gs_plugin_get_name (plugin));
 }
 
-/**
- * _gs_app_get_id_nonfull:
- */
 static gchar *
 _gs_app_get_id_nonfull (GsApp *app)
 {
@@ -79,9 +70,6 @@ _gs_app_get_id_nonfull (GsApp *app)
        return id;
 }
 
-/**
- * gs_plugin_app_install:
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin, GsApp *app,
                       GCancellable *cancellable, GError **error)
@@ -209,9 +197,6 @@ gs_plugin_app_install (GsPlugin *plugin, GsApp *app,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_remove:
- */
 gboolean
 gs_plugin_app_remove (GsPlugin *plugin, GsApp *app,
                      GCancellable *cancellable, GError **error)
@@ -247,9 +232,6 @@ gs_plugin_app_remove (GsPlugin *plugin, GsApp *app,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
@@ -296,9 +278,6 @@ gs_plugin_refine_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_launch:
- */
 gboolean
 gs_plugin_launch (GsPlugin *plugin,
                  GsApp *app,
diff --git a/src/plugins/gs-plugin-fedora-distro-upgrades.c b/src/plugins/gs-plugin-fedora-distro-upgrades.c
index 5429ca3..daeed91 100644
--- a/src/plugins/gs-plugin-fedora-distro-upgrades.c
+++ b/src/plugins/gs-plugin-fedora-distro-upgrades.c
@@ -33,9 +33,6 @@ struct GsPluginData {
        guint64          os_version;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -48,9 +45,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        }
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -61,9 +55,6 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_free (priv->cachefn);
 }
 
-/**
- * gs_plugin_fedora_distro_upgrades_changed_cb:
- */
 static void
 gs_plugin_fedora_distro_upgrades_changed_cb (GFileMonitor *monitor,
                                             GFile *file,
@@ -87,9 +78,6 @@ gs_plugin_fedora_distro_upgrades_changed_cb (GFileMonitor *monitor,
        gs_plugin_updates_changed (plugin);
 }
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -143,9 +131,6 @@ gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_fedora_distro_upgrades_refresh:
- */
 static gboolean
 gs_plugin_fedora_distro_upgrades_refresh (GsPlugin *plugin,
                                          guint cache_age,
@@ -173,9 +158,6 @@ gs_plugin_fedora_distro_upgrades_refresh (GsPlugin *plugin,
                                        error);
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
@@ -299,9 +281,6 @@ parse_pkgdb_collections_data (const gchar *data,
        return distros;
 }
 
-/**
- * gs_plugin_add_distro_upgrades:
- */
 gboolean
 gs_plugin_add_distro_upgrades (GsPlugin *plugin,
                               GsAppList *list,
diff --git a/src/plugins/gs-plugin-fedora-tagger-usage.c b/src/plugins/gs-plugin-fedora-tagger-usage.c
index ab07623..62b73a3 100644
--- a/src/plugins/gs-plugin-fedora-tagger-usage.c
+++ b/src/plugins/gs-plugin-fedora-tagger-usage.c
@@ -35,9 +35,6 @@
 
 #define GS_PLUGIN_FEDORA_TAGGER_SERVER         "https://apps.fedoraproject.org/tagger";
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -63,9 +60,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "packagekit");
 }
 
-/**
- * gs_plugin_app_set_usage_pkg:
- */
 static gboolean
 gs_plugin_app_set_usage_pkg (GsPlugin *plugin,
                             const gchar *pkgname,
@@ -103,9 +97,6 @@ gs_plugin_app_set_usage_pkg (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_set_usage_app:
- */
 static gboolean
 gs_plugin_app_set_usage_app (GsPlugin *plugin,
                             GsApp *app,
@@ -135,9 +126,6 @@ gs_plugin_app_set_usage_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_install:
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin,
                       GsApp *app,
@@ -149,9 +137,6 @@ gs_plugin_app_install (GsPlugin *plugin,
        return gs_plugin_app_set_usage_app (plugin, app, TRUE, error);
 }
 
-/**
- * gs_plugin_app_remove:
- */
 gboolean
 gs_plugin_app_remove (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-flatpak.c b/src/plugins/gs-plugin-flatpak.c
index b067a04..9cc9e85 100644
--- a/src/plugins/gs-plugin-flatpak.c
+++ b/src/plugins/gs-plugin-flatpak.c
@@ -43,9 +43,6 @@ struct GsPluginData {
        GFileMonitor            *monitor;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -58,9 +55,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_CONFLICTS, "xdg-app");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -71,9 +65,6 @@ gs_plugin_destroy (GsPlugin *plugin)
                g_object_unref (priv->monitor);
 }
 
-/**
- * gs_plugin_adopt_app:
- */
 void
 gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
 {
@@ -94,9 +85,6 @@ gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
 #define gs_app_set_flatpak_branch(app,val)     gs_app_set_metadata(app,"flatpak::branch",val)
 #define gs_app_set_flatpak_commit(app,val)     gs_app_set_metadata(app,"flatpak::commit",val)
 
-/**
- * gs_app_get_flatpak_kind:
- */
 static FlatpakRefKind
 gs_app_get_flatpak_kind (GsApp *app)
 {
@@ -109,9 +97,6 @@ gs_app_get_flatpak_kind (GsApp *app)
        return FLATPAK_REF_KIND_APP;
 }
 
-/**
- * gs_app_set_flatpak_kind:
- */
 static void
 gs_app_set_flatpak_kind (GsApp *app, FlatpakRefKind kind)
 {
@@ -124,9 +109,6 @@ gs_app_set_flatpak_kind (GsApp *app, FlatpakRefKind kind)
 }
 
 #ifndef HAVE_PACKAGEKIT
-/**
- * gs_plugin_add_popular:
- */
 gboolean
 gs_plugin_add_popular (GsPlugin *plugin,
                       GsAppList *list,
@@ -156,9 +138,6 @@ gs_plugin_add_popular (GsPlugin *plugin,
 }
 #endif
 
-/**
- * gs_plugin_flatpak_changed_cb:
- */
 static void
 gs_plugin_flatpak_changed_cb (GFileMonitor *monitor,
                              GFile *child,
@@ -169,9 +148,6 @@ gs_plugin_flatpak_changed_cb (GFileMonitor *monitor,
        gs_plugin_updates_changed (plugin);
 }
 
-/**
- * gs_plugin_refresh_appstream:
- */
 static gboolean
 gs_plugin_refresh_appstream (GsPlugin *plugin,
                             guint cache_age,
@@ -245,9 +221,6 @@ gs_plugin_refresh_appstream (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -289,9 +262,6 @@ gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_flatpak_set_metadata:
- */
 static void
 gs_plugin_flatpak_set_metadata (GsApp *app, FlatpakRef *xref)
 {
@@ -303,9 +273,6 @@ gs_plugin_flatpak_set_metadata (GsApp *app, FlatpakRef *xref)
        gs_app_set_flatpak_commit (app, flatpak_ref_get_commit (xref));
 }
 
-/**
- * gs_plugin_flatpak_set_metadata_installed:
- */
 static void
 gs_plugin_flatpak_set_metadata_installed (GsApp *app, FlatpakInstalledRef *xref)
 {
@@ -342,9 +309,6 @@ gs_plugin_flatpak_set_metadata_installed (GsApp *app, FlatpakInstalledRef *xref)
                gs_app_set_size_installed (app, size_installed);
 }
 
-/**
- * gs_plugin_flatpak_build_id:
- */
 static gchar *
 gs_plugin_flatpak_build_id (FlatpakInstallation *installation, FlatpakRef *xref)
 {
@@ -365,9 +329,6 @@ gs_plugin_flatpak_build_id (FlatpakInstallation *installation, FlatpakRef *xref)
                                flatpak_ref_get_name (xref));
 }
 
-/**
- * gs_plugin_flatpak_create_installed:
- */
 static GsApp *
 gs_plugin_flatpak_create_installed (GsPlugin *plugin,
                                    FlatpakInstalledRef *xref,
@@ -434,9 +395,6 @@ gs_plugin_flatpak_create_installed (GsPlugin *plugin,
        return g_object_ref (app);
 }
 
-/**
- * gs_plugin_flatpak_progress_cb:
- */
 static void
 gs_plugin_flatpak_progress_cb (const gchar *status,
                               guint progress,
@@ -447,9 +405,6 @@ gs_plugin_flatpak_progress_cb (const gchar *status,
        gs_app_set_progress (app, progress);
 }
 
-/**
- * gs_plugin_add_installed:
- */
 gboolean
 gs_plugin_add_installed (GsPlugin *plugin,
                         GsAppList *list,
@@ -496,9 +451,6 @@ gs_plugin_add_installed (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_sources:
- */
 gboolean
 gs_plugin_add_sources (GsPlugin *plugin,
                       GsAppList *list,
@@ -541,10 +493,6 @@ gs_plugin_add_sources (GsPlugin *plugin,
        return TRUE;
 }
 
-
-/**
- * gs_plugin_add_source:
- */
 gboolean
 gs_plugin_add_source (GsPlugin *plugin,
                      GsApp *app,
@@ -581,9 +529,6 @@ gs_plugin_add_source (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_updates:
- */
 gboolean
 gs_plugin_add_updates (GsPlugin *plugin,
                       GsAppList *list,
@@ -641,9 +586,6 @@ gs_plugin_add_updates (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
@@ -698,9 +640,6 @@ gs_plugin_refresh (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_origin_ui:
- */
 static gboolean
 gs_plugin_refine_item_origin_ui (GsPlugin *plugin,
                                 GsApp *app,
@@ -738,9 +677,6 @@ gs_plugin_refine_item_origin_ui (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_origin:
- */
 static gboolean
 gs_plugin_refine_item_origin (GsPlugin *plugin,
                              GsApp *app,
@@ -802,9 +738,6 @@ gs_plugin_refine_item_origin (GsPlugin *plugin,
        return FALSE;
 }
 
-/**
- * gs_plugin_flatpak_app_matches_xref:
- */
 static gboolean
 gs_plugin_flatpak_app_matches_xref (GsPlugin *plugin, GsApp *app, FlatpakRef *xref)
 {
@@ -829,9 +762,6 @@ gs_plugin_flatpak_app_matches_xref (GsPlugin *plugin, GsApp *app, FlatpakRef *xr
        return FALSE;
 }
 
-/**
- * gs_plugin_flatpak_create_fake_ref:
- */
 static FlatpakRef *
 gs_plugin_flatpak_create_fake_ref (GsApp *app, GError **error)
 {
@@ -844,9 +774,6 @@ gs_plugin_flatpak_create_fake_ref (GsApp *app, GError **error)
        return flatpak_ref_parse (id, error);
 }
 
-/**
- * gs_plugin_refine_item_metadata:
- */
 static gboolean
 gs_plugin_refine_item_metadata (GsPlugin *plugin,
                                GsApp *app,
@@ -885,9 +812,6 @@ gs_plugin_refine_item_metadata (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_state:
- */
 static gboolean
 gs_plugin_refine_item_state (GsPlugin *plugin,
                              GsApp *app,
@@ -955,9 +879,6 @@ gs_plugin_refine_item_state (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_flatpak_set_app_metadata:
- */
 static gboolean
 gs_plugin_flatpak_set_app_metadata (GsApp *app,
                                    const gchar *data,
@@ -990,9 +911,6 @@ gs_plugin_flatpak_set_app_metadata (GsApp *app,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_runtime:
- */
 static gboolean
 gs_plugin_refine_item_runtime (GsPlugin *plugin,
                               GsApp *app,
@@ -1054,9 +972,6 @@ gs_plugin_refine_item_runtime (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_size:
- */
 static gboolean
 gs_plugin_refine_item_size (GsPlugin *plugin,
                            GsApp *app,
@@ -1137,9 +1052,6 @@ gs_plugin_refine_item_size (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_flatpak_refine_app:
- */
 static gboolean
 gs_plugin_flatpak_refine_app (GsPlugin *plugin,
                              GsApp *app,
@@ -1194,9 +1106,6 @@ gs_plugin_flatpak_refine_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
@@ -1206,9 +1115,6 @@ gs_plugin_refine_app (GsPlugin *plugin,
 {      return gs_plugin_flatpak_refine_app (plugin, app, flags, cancellable, error);
 }
 
-/**
- * gs_plugin_launch:
- */
 gboolean
 gs_plugin_launch (GsPlugin *plugin,
                  GsApp *app,
@@ -1235,9 +1141,6 @@ gs_plugin_launch (GsPlugin *plugin,
                                            error);
 }
 
-/**
- * gs_plugin_app_remove:
- */
 gboolean
 gs_plugin_app_remove (GsPlugin *plugin,
                      GsApp *app,
@@ -1281,9 +1184,6 @@ gs_plugin_app_remove (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_install:
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin,
                       GsApp *app,
@@ -1378,9 +1278,6 @@ gs_plugin_app_install (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_update_app:
- */
 gboolean
 gs_plugin_update_app (GsPlugin *plugin,
                      GsApp *app,
@@ -1415,9 +1312,6 @@ gs_plugin_update_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_file_to_app:
- */
 gboolean
 gs_plugin_file_to_app (GsPlugin *plugin,
                       GsAppList *list,
diff --git a/src/plugins/gs-plugin-fwupd.c b/src/plugins/gs-plugin-fwupd.c
index d4d41d0..c8305ec 100644
--- a/src/plugins/gs-plugin-fwupd.c
+++ b/src/plugins/gs-plugin-fwupd.c
@@ -46,9 +46,6 @@ struct GsPluginData {
        gchar                   *config_fn;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -67,9 +64,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        }
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -82,9 +76,6 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_ptr_array_unref (priv->to_ignore);
 }
 
-/**
- * gs_plugin_adopt_app:
- */
 void
 gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
 {
@@ -92,9 +83,6 @@ gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
                gs_app_set_management_plugin (app, gs_plugin_get_name (plugin));
 }
 
-/**
- * gs_plugin_fwupd_changed_cb:
- */
 static void
 gs_plugin_fwupd_changed_cb (FwupdClient *client, GsPlugin *plugin)
 {
@@ -105,9 +93,6 @@ gs_plugin_fwupd_changed_cb (FwupdClient *client, GsPlugin *plugin)
 }
 
 #if FWUPD_CHECK_VERSION(0,7,1)
-/**
- * gs_plugin_fwupd_device_changed_cb:
- */
 static void
 gs_plugin_fwupd_device_changed_cb (FwupdClient *client,
                                   FwupdResult *device,
@@ -129,9 +114,6 @@ gs_plugin_fwupd_device_changed_cb (FwupdClient *client,
 }
 #endif
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -170,9 +152,6 @@ gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_fwupd_add_required_location:
- */
 static void
 gs_plugin_fwupd_add_required_location (GsPlugin *plugin, const gchar *location)
 {
@@ -192,9 +171,6 @@ gs_plugin_fwupd_add_required_location (GsPlugin *plugin, const gchar *location)
        g_ptr_array_add (priv->to_download, g_strdup (location));
 }
 
-/**
- * gs_plugin_fwupd_get_file_checksum:
- */
 static gchar *
 gs_plugin_fwupd_get_file_checksum (const gchar *filename,
                                   GChecksumType checksum_type,
@@ -208,9 +184,6 @@ gs_plugin_fwupd_get_file_checksum (const gchar *filename,
        return g_compute_checksum_for_data (checksum_type, (const guchar *)data, len);
 }
 
-/**
- * gs_plugin_fwupd_new_app_from_results:
- */
 static GsApp *
 gs_plugin_fwupd_new_app_from_results (FwupdResult *res)
 {
@@ -303,9 +276,6 @@ gs_plugin_fwupd_new_app_from_results (FwupdResult *res)
        return app;
 }
 
-/**
- * gs_plugin_add_update_app:
- */
 static gboolean
 gs_plugin_add_update_app (GsPlugin *plugin,
                          GsAppList *list,
@@ -415,9 +385,6 @@ gs_plugin_add_update_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_updates_historical:
- */
 gboolean
 gs_plugin_add_updates_historical (GsPlugin *plugin,
                                  GsAppList *list,
@@ -456,9 +423,6 @@ gs_plugin_add_updates_historical (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_updates:
- */
 gboolean
 gs_plugin_add_updates (GsPlugin *plugin,
                       GsAppList *list,
@@ -496,9 +460,6 @@ gs_plugin_add_updates (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_fwupd_check_lvfs_metadata:
- */
 static gboolean
 gs_plugin_fwupd_check_lvfs_metadata (GsPlugin *plugin,
                                     guint cache_age,
@@ -604,9 +565,6 @@ gs_plugin_fwupd_check_lvfs_metadata (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
@@ -677,9 +635,6 @@ gs_plugin_refresh (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_fwupd_install:
- */
 static gboolean
 gs_plugin_fwupd_install (GsPlugin *plugin,
                         GsApp *app,
@@ -722,11 +677,6 @@ gs_plugin_fwupd_install (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_install:
- *
- * Called when a user double clicks on a .cab file
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin,
                       GsApp *app,
@@ -741,11 +691,6 @@ gs_plugin_app_install (GsPlugin *plugin,
        return gs_plugin_fwupd_install (plugin, app, cancellable, error);
 }
 
-/**
- * gs_plugin_update_app:
- *
- * Called when a user clicks [Update] in the updates panel
- */
 gboolean
 gs_plugin_update_app (GsPlugin *plugin,
                      GsApp *app,
@@ -776,9 +721,6 @@ gs_plugin_update_app (GsPlugin *plugin,
        return gs_plugin_fwupd_install (plugin, app, cancellable, error);
 }
 
-/**
- * gs_plugin_file_to_app:
- */
 gboolean
 gs_plugin_file_to_app (GsPlugin *plugin,
                       GsAppList *list,
diff --git a/src/plugins/gs-plugin-hardcoded-blacklist.c b/src/plugins/gs-plugin-hardcoded-blacklist.c
index efa2b0b..1bd8ded 100644
--- a/src/plugins/gs-plugin-hardcoded-blacklist.c
+++ b/src/plugins/gs-plugin-hardcoded-blacklist.c
@@ -29,9 +29,6 @@
  * Blacklists some applications based on a hardcoded list.
  */
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -39,9 +36,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "appstream");
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-icons.c b/src/plugins/gs-plugin-icons.c
index 90fe28d..6d9651a 100644
--- a/src/plugins/gs-plugin-icons.c
+++ b/src/plugins/gs-plugin-icons.c
@@ -40,9 +40,6 @@ struct GsPluginData {
        GHashTable              *icon_theme_paths;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -56,9 +53,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "epiphany");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -68,9 +62,6 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_mutex_clear (&priv->icon_theme_lock);
 }
 
-/**
- * gs_plugin_icons_download:
- */
 static gboolean
 gs_plugin_icons_download (GsPlugin *plugin, const gchar *uri, const gchar *filename, GError **error)
 {
@@ -120,9 +111,6 @@ gs_plugin_icons_download (GsPlugin *plugin, const gchar *uri, const gchar *filen
        return gdk_pixbuf_save (pixbuf_new, filename, "png", error, NULL);
 }
 
-/**
- * gs_plugin_icons_load_local:
- */
 static gboolean
 gs_plugin_icons_load_local (GsPlugin *plugin, GsApp *app, GError **error)
 {
@@ -148,9 +136,6 @@ gs_plugin_icons_load_local (GsPlugin *plugin, GsApp *app, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_icons_add_theme_path:
- */
 static void
 gs_plugin_icons_add_theme_path (GsPlugin *plugin, const gchar *path)
 {
@@ -163,9 +148,6 @@ gs_plugin_icons_add_theme_path (GsPlugin *plugin, const gchar *path)
        }
 }
 
-/**
- * gs_plugin_icons_load_stock:
- */
 static gboolean
 gs_plugin_icons_load_stock (GsPlugin *plugin, GsApp *app, GError **error)
 {
@@ -196,9 +178,6 @@ gs_plugin_icons_load_stock (GsPlugin *plugin, GsApp *app, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-key-colors.c b/src/plugins/gs-plugin-key-colors.c
index 1fc5f03..bb2ad9d 100644
--- a/src/plugins/gs-plugin-key-colors.c
+++ b/src/plugins/gs-plugin-key-colors.c
@@ -23,9 +23,6 @@
 
 #include <gnome-software.h>
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -39,9 +36,6 @@ typedef struct {
        guint8           B;
 } CdColorRGB8;
 
-/**
- * cd_color_rgb8_to_uint32:
- */
 static guint32
 cd_color_rgb8_to_uint32 (CdColorRGB8 *rgb)
 {
@@ -55,9 +49,6 @@ typedef struct {
        guint           cnt;
 } GsColorBin;
 
-/**
- * gs_color_bin_sort_cb:
- */
 static gint
 gs_color_bin_sort_cb (gconstpointer a, gconstpointer b)
 {
@@ -70,9 +61,6 @@ gs_color_bin_sort_cb (gconstpointer a, gconstpointer b)
        return 0;
 }
 
-/**
- * gs_plugin_key_colors_set_for_pixbuf:
- */
 static void
 gs_plugin_key_colors_set_for_pixbuf (GsApp *app, GdkPixbuf *pb, guint number)
 {
@@ -160,9 +148,6 @@ gs_plugin_key_colors_set_for_pixbuf (GsApp *app, GdkPixbuf *pb, guint number)
        }
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-limba.c b/src/plugins/gs-plugin-limba.c
index aee22cd..246d9cc 100644
--- a/src/plugins/gs-plugin-limba.c
+++ b/src/plugins/gs-plugin-limba.c
@@ -34,9 +34,6 @@ struct GsPluginData {
        LiManager       *mgr;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -48,9 +45,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "packagekit");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -58,9 +52,6 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_object_unref (priv->mgr);
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
@@ -112,8 +103,7 @@ gs_plugin_refine_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * GsPluginHelper:
+/*
  * Helper structure for Limba callbacks.
  */
 typedef struct {
@@ -121,9 +111,6 @@ typedef struct {
        GsPlugin        *plugin;
 } GsPluginHelper;
 
-/**
- * gs_plugin_installer_progress_cb:
- */
 static void
 gs_plugin_installer_progress_cb (LiInstaller *inst, guint percentage, const gchar *id, gpointer user_data)
 {
@@ -138,9 +125,6 @@ gs_plugin_installer_progress_cb (LiInstaller *inst, guint percentage, const gcha
        gs_app_set_progress (helper->app, percentage);
 }
 
-/**
- * gs_plugin_manager_progress_cb:
- */
 static void
 gs_plugin_manager_progress_cb (LiManager *mgr, guint percentage, const gchar *id, gpointer user_data)
 {
@@ -155,9 +139,6 @@ gs_plugin_manager_progress_cb (LiManager *mgr, guint percentage, const gchar *id
        gs_app_set_progress (helper->app, percentage);
 }
 
-/**
- * gs_plugin_app_remove:
- */
 gboolean
 gs_plugin_app_remove (GsPlugin *plugin,
                        GsApp *app,
@@ -202,9 +183,6 @@ gs_plugin_app_remove (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_install:
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin,
                        GsApp *app,
@@ -260,9 +238,6 @@ gs_plugin_app_install (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_sources:
- */
 gboolean
 gs_plugin_add_sources (GsPlugin *plugin,
                       GsAppList *list,
@@ -274,9 +249,6 @@ gs_plugin_add_sources (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
@@ -305,9 +277,6 @@ gs_plugin_refresh (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_from_pki:
- */
 static GsApp*
 gs_plugin_app_from_pki (LiPkgInfo *pki)
 {
@@ -342,9 +311,6 @@ gs_plugin_app_from_pki (LiPkgInfo *pki)
        return app;
 }
 
-/**
- * gs_plugin_add_sources:
- */
 gboolean
 gs_plugin_add_installed (GsPlugin *plugin,
                         GsAppList *list,
@@ -379,9 +345,6 @@ gs_plugin_add_installed (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_updates:
- */
 gboolean
 gs_plugin_add_updates (GsPlugin *plugin,
                        GsAppList *list,
@@ -421,11 +384,6 @@ gs_plugin_add_updates (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_update_app:
- *
- * Used only for online-updates.
- */
 gboolean
 gs_plugin_update_app (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-menu-spec-categories.c b/src/plugins/gs-plugin-menu-spec-categories.c
index bd143ef..94e026c 100644
--- a/src/plugins/gs-plugin-menu-spec-categories.c
+++ b/src/plugins/gs-plugin-menu-spec-categories.c
@@ -32,9 +32,6 @@
  * specification.
  */
 
-/**
- * gs_plugin_add_categories:
- */
 gboolean
 gs_plugin_add_categories (GsPlugin *plugin,
                          GPtrArray *list,
diff --git a/src/plugins/gs-plugin-menu-spec-refine.c b/src/plugins/gs-plugin-menu-spec-refine.c
index 9a9e69f..6db6c6f 100644
--- a/src/plugins/gs-plugin-menu-spec-refine.c
+++ b/src/plugins/gs-plugin-menu-spec-refine.c
@@ -32,9 +32,6 @@
  * previously set.
  */
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -43,9 +40,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "menu-spec-categories");
 }
 
-/**
- * gs_plugin_refine_app_category:
- */
 static void
 gs_plugin_refine_app_category (GsPlugin *plugin,
                               GsApp *app,
@@ -79,9 +73,6 @@ gs_plugin_refine_app_category (GsPlugin *plugin,
        gs_app_set_menu_path (app, (gchar **) menu_path);
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-odrs.c b/src/plugins/gs-plugin-odrs.c
index 4b2b90f..91dff81 100644
--- a/src/plugins/gs-plugin-odrs.c
+++ b/src/plugins/gs-plugin-odrs.c
@@ -40,9 +40,6 @@ struct GsPluginData {
        gchar                   *review_server;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -79,9 +76,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "flatpak");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -91,9 +85,6 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_object_unref (priv->settings);
 }
 
-/**
- * gs_plugin_odrs_parse_review_object:
- */
 static GsReview *
 gs_plugin_odrs_parse_review_object (JsonObject *item)
 {
@@ -151,9 +142,6 @@ gs_plugin_odrs_parse_review_object (JsonObject *item)
        return rev;
 }
 
-/**
- * gs_plugin_odrs_parse_reviews:
- */
 static GPtrArray *
 gs_plugin_odrs_parse_reviews (const gchar *data, gsize data_len, GError **error)
 {
@@ -225,9 +213,6 @@ gs_plugin_odrs_parse_reviews (const gchar *data, gsize data_len, GError **error)
        return g_steal_pointer (&reviews);
 }
 
-/**
- * gs_plugin_odrs_parse_success:
- */
 static gboolean
 gs_plugin_odrs_parse_success (const gchar *data, gsize data_len, GError **error)
 {
@@ -290,9 +275,6 @@ gs_plugin_odrs_parse_success (const gchar *data, gsize data_len, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_odrs_json_post:
- */
 static gboolean
 gs_plugin_odrs_json_post (SoupSession *session,
                          const gchar *uri,
@@ -322,9 +304,6 @@ gs_plugin_odrs_json_post (SoupSession *session,
                                             error);
 }
 
-/**
- * gs_plugin_odrs_parse_ratings:
- */
 static GArray *
 gs_plugin_odrs_parse_ratings (const gchar *data, gsize data_len, GError **error)
 {
@@ -385,9 +364,6 @@ gs_plugin_odrs_parse_ratings (const gchar *data, gsize data_len, GError **error)
        return ratings;
 }
 
-/**
- * gs_plugin_odrs_get_ratings:
- */
 static GArray *
 gs_plugin_odrs_get_ratings (GsPlugin *plugin, GsApp *app, GError **error)
 {
@@ -455,9 +431,6 @@ gs_plugin_odrs_get_ratings (GsPlugin *plugin, GsApp *app, GError **error)
        return ratings;
 }
 
-/**
- * gs_plugin_refine_ratings:
- */
 static gboolean
 gs_plugin_refine_ratings (GsPlugin *plugin,
                          GsApp *app,
@@ -490,9 +463,6 @@ gs_plugin_refine_ratings (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_odrs_fetch_for_app:
- */
 static GPtrArray *
 gs_plugin_odrs_fetch_for_app (GsPlugin *plugin, GsApp *app, GError **error)
 {
@@ -598,9 +568,6 @@ gs_plugin_odrs_fetch_for_app (GsPlugin *plugin, GsApp *app, GError **error)
        return g_steal_pointer (&reviews);
 }
 
-/**
- * gs_plugin_refine_reviews:
- */
 static gboolean
 gs_plugin_refine_reviews (GsPlugin *plugin,
                          GsApp *app,
@@ -642,9 +609,6 @@ gs_plugin_refine_reviews (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
@@ -679,9 +643,6 @@ gs_plugin_refine_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_odrs_sanitize_version:
- */
 static gchar *
 gs_plugin_odrs_sanitize_version (const gchar *version)
 {
@@ -692,9 +653,6 @@ gs_plugin_odrs_sanitize_version (const gchar *version)
        return tmp;
 }
 
-/**
- * gs_plugin_odrs_invalidate_cache:
- */
 static gboolean
 gs_plugin_odrs_invalidate_cache (GsReview *review, GError **error)
 {
@@ -717,9 +675,6 @@ gs_plugin_odrs_invalidate_cache (GsReview *review, GError **error)
        return g_file_delete (cachefn_file, NULL, error);
 }
 
-/**
- * gs_plugin_review_submit:
- */
 gboolean
 gs_plugin_review_submit (GsPlugin *plugin,
                         GsApp *app,
@@ -786,9 +741,6 @@ gs_plugin_review_submit (GsPlugin *plugin,
                                                    uri, data, error);
 }
 
-/**
- * gs_plugin_odrs_vote:
- */
 static gboolean
 gs_plugin_odrs_vote (GsPlugin *plugin, GsReview *review,
                     const gchar *uri, GError **error)
@@ -846,9 +798,6 @@ gs_plugin_odrs_vote (GsPlugin *plugin, GsReview *review,
        return TRUE;
 }
 
-/**
- * gs_plugin_review_report:
- */
 gboolean
 gs_plugin_review_report (GsPlugin *plugin,
                         GsApp *app,
@@ -862,9 +811,6 @@ gs_plugin_review_report (GsPlugin *plugin,
        return gs_plugin_odrs_vote (plugin, review, uri, error);
 }
 
-/**
- * gs_plugin_review_upvote:
- */
 gboolean
 gs_plugin_review_upvote (GsPlugin *plugin,
                         GsApp *app,
@@ -878,9 +824,6 @@ gs_plugin_review_upvote (GsPlugin *plugin,
        return gs_plugin_odrs_vote (plugin, review, uri, error);
 }
 
-/**
- * gs_plugin_review_downvote:
- */
 gboolean
 gs_plugin_review_downvote (GsPlugin *plugin,
                           GsApp *app,
@@ -894,9 +837,6 @@ gs_plugin_review_downvote (GsPlugin *plugin,
        return gs_plugin_odrs_vote (plugin, review, uri, error);
 }
 
-/**
- * gs_plugin_review_dismiss:
- */
 gboolean
 gs_plugin_review_dismiss (GsPlugin *plugin,
                          GsApp *app,
@@ -910,9 +850,6 @@ gs_plugin_review_dismiss (GsPlugin *plugin,
        return gs_plugin_odrs_vote (plugin, review, uri, error);
 }
 
-/**
- * gs_plugin_review_remove:
- */
 gboolean
 gs_plugin_review_remove (GsPlugin *plugin,
                         GsApp *app,
@@ -926,9 +863,6 @@ gs_plugin_review_remove (GsPlugin *plugin,
        return gs_plugin_odrs_vote (plugin, review, uri, error);
 }
 
-/**
- * gs_plugin_create_app_dummy:
- */
 static GsApp *
 gs_plugin_create_app_dummy (const gchar *id)
 {
@@ -943,9 +877,6 @@ gs_plugin_create_app_dummy (const gchar *id)
        return app;
 }
 
-/**
- * gs_plugin_add_unvoted_reviews:
- */
 gboolean
 gs_plugin_add_unvoted_reviews (GsPlugin *plugin,
                               GsAppList *list,
diff --git a/src/plugins/gs-plugin-ostree.c b/src/plugins/gs-plugin-ostree.c
index 5148282..adf3d7f 100644
--- a/src/plugins/gs-plugin-ostree.c
+++ b/src/plugins/gs-plugin-ostree.c
@@ -31,9 +31,6 @@ struct GsPluginData {
        OstreeRepo              *ostree_repo;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -56,9 +53,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_CONFLICTS, "systemd-updates");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -67,9 +61,6 @@ gs_plugin_destroy (GsPlugin *plugin)
                g_object_unref (priv->ostree_repo);
 }
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -86,9 +77,6 @@ gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_add_sources:
- */
 gboolean
 gs_plugin_add_sources (GsPlugin *plugin,
                       GsAppList *list,
@@ -124,9 +112,6 @@ gs_plugin_add_sources (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
diff --git a/src/plugins/gs-plugin-packagekit-history.c b/src/plugins/gs-plugin-packagekit-history.c
index 08677aa..0dbf3c3 100644
--- a/src/plugins/gs-plugin-packagekit-history.c
+++ b/src/plugins/gs-plugin-packagekit-history.c
@@ -37,9 +37,6 @@ struct GsPluginData {
        GDBusConnection         *connection;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -50,9 +47,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "packagekit-refine");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -61,9 +55,6 @@ gs_plugin_destroy (GsPlugin *plugin)
                g_object_unref (priv->connection);
 }
 
-/**
- * gs_plugin_packagekit_refine_add_history:
- */
 static void
 gs_plugin_packagekit_refine_add_history (GsApp *app, GVariant *dict)
 {
@@ -114,9 +105,6 @@ gs_plugin_packagekit_refine_add_history (GsApp *app, GVariant *dict)
        gs_app_set_install_date (app, timestamp);
 }
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -229,9 +217,6 @@ gs_plugin_packagekit_refine (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine:
- */
 gboolean
 gs_plugin_refine (GsPlugin *plugin,
                  GsAppList *list,
diff --git a/src/plugins/gs-plugin-packagekit-local.c b/src/plugins/gs-plugin-packagekit-local.c
index 741b4c3..ed2b683 100644
--- a/src/plugins/gs-plugin-packagekit-local.c
+++ b/src/plugins/gs-plugin-packagekit-local.c
@@ -33,9 +33,6 @@ struct GsPluginData {
        PkTask                  *task;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -45,9 +42,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        pk_client_set_interactive (PK_CLIENT (priv->task), FALSE);
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -60,9 +54,6 @@ typedef struct {
        GsPlugin        *plugin;
 } ProgressData;
 
-/**
- * gs_plugin_packagekit_progress_cb:
- **/
 static void
 gs_plugin_packagekit_progress_cb (PkProgress *progress,
                                  PkProgressType type,
@@ -85,7 +76,7 @@ gs_plugin_packagekit_progress_cb (PkProgress *progress,
        }
 }
 
-/**
+/*
  * gs_plugin_packagekit_refresh_set_text:
  *
  * The cases we have to deal with:
@@ -118,9 +109,6 @@ gs_plugin_packagekit_refresh_set_text (GsApp *app, const gchar *text)
        gs_app_set_description (app, GS_APP_QUALITY_LOWEST, nl + 1);
 }
 
-/**
- * gs_plugin_packagekit_refresh_guess_app_id:
- */
 static gboolean
 gs_plugin_packagekit_refresh_guess_app_id (GsPlugin *plugin,
                                           GsApp *app,
@@ -180,9 +168,6 @@ gs_plugin_packagekit_refresh_guess_app_id (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_file_to_app:
- */
 gboolean
 gs_plugin_file_to_app (GsPlugin *plugin,
                       GsAppList *list,
diff --git a/src/plugins/gs-plugin-packagekit-offline.c b/src/plugins/gs-plugin-packagekit-offline.c
index fa8a785..66c34b1 100644
--- a/src/plugins/gs-plugin-packagekit-offline.c
+++ b/src/plugins/gs-plugin-packagekit-offline.c
@@ -37,9 +37,6 @@
 #define PK_OFFLINE_UPDATE_RESULTS_GROUP                "PackageKit Offline Update Results"
 #define PK_OFFLINE_UPDATE_RESULTS_FILENAME     "/var/lib/PackageKit/offline-update-competed"
 
-/**
- * gs_plugin_packagekit_convert_error:
- */
 static gboolean
 gs_plugin_packagekit_convert_error (GError **error,
                                    PkErrorEnum error_enum,
@@ -96,9 +93,6 @@ gs_plugin_packagekit_convert_error (GError **error,
        return FALSE;
 }
 
-/**
- * gs_plugin_add_updates_historical:
- */
 gboolean
 gs_plugin_add_updates_historical (GsPlugin *plugin,
                                  GsAppList *list,
diff --git a/src/plugins/gs-plugin-packagekit-origin.c b/src/plugins/gs-plugin-packagekit-origin.c
index d96c428..04e76d0 100644
--- a/src/plugins/gs-plugin-packagekit-origin.c
+++ b/src/plugins/gs-plugin-packagekit-origin.c
@@ -41,9 +41,6 @@ struct GsPluginData {
        GHashTable              *sources;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -61,9 +58,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "packagekit-refine");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -72,9 +66,6 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_object_unref (priv->client);
 }
 
-/**
- * gs_plugin_packagekit_origin_ensure_sources:
- **/
 static gboolean
 gs_plugin_packagekit_origin_ensure_sources (GsPlugin *plugin,
                                            GCancellable *cancellable,
@@ -108,9 +99,6 @@ gs_plugin_packagekit_origin_ensure_sources (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-packagekit-proxy.c b/src/plugins/gs-plugin-packagekit-proxy.c
index 28699d5..d429abc 100644
--- a/src/plugins/gs-plugin-packagekit-proxy.c
+++ b/src/plugins/gs-plugin-packagekit-proxy.c
@@ -154,9 +154,6 @@ reload_proxy_settings (GsPlugin *plugin, GCancellable *cancellable)
                                    plugin);
 }
 
-/**
- * gs_plugin_packagekit_proxy_changed_cb:
- */
 static void
 gs_plugin_packagekit_proxy_changed_cb (GSettings *settings,
                                       const gchar *key,
@@ -167,9 +164,6 @@ gs_plugin_packagekit_proxy_changed_cb (GSettings *settings,
        reload_proxy_settings (plugin, NULL);
 }
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -186,9 +180,6 @@ gs_plugin_initialize (GsPlugin *plugin)
                          G_CALLBACK (gs_plugin_packagekit_proxy_changed_cb), plugin);
 }
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -196,9 +187,6 @@ gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
diff --git a/src/plugins/gs-plugin-packagekit-refine.c b/src/plugins/gs-plugin-packagekit-refine.c
index 122d234..1321db6 100644
--- a/src/plugins/gs-plugin-packagekit-refine.c
+++ b/src/plugins/gs-plugin-packagekit-refine.c
@@ -44,18 +44,12 @@ struct GsPluginData {
        AsProfileTask           *ptask;
 };
 
-/**
- * gs_plugin_initialize:
- */
 static void
 gs_plugin_packagekit_cache_invalid_cb (PkControl *control, GsPlugin *plugin)
 {
        gs_plugin_updates_changed (plugin);
 }
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -78,9 +72,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "packagekit");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -89,9 +80,6 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_object_unref (priv->control);
 }
 
-/**
- * gs_plugin_adopt_app:
- */
 void
 gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
 {
@@ -112,9 +100,6 @@ typedef struct {
        gchar           *profile_id;
 } ProgressData;
 
-/**
- * gs_plugin_packagekit_progress_cb:
- **/
 static void
 gs_plugin_packagekit_progress_cb (PkProgress *progress,
                                  PkProgressType type,
@@ -187,9 +172,6 @@ gs_plugin_packagekit_set_metadata_from_package (GsPlugin *plugin,
                            pk_package_get_summary (package));
 }
 
-/**
- * gs_plugin_packagekit_resolve_packages_app:
- **/
 static void
 gs_plugin_packagekit_resolve_packages_app (GsPlugin *plugin,
                                           GPtrArray *packages,
@@ -254,9 +236,6 @@ gs_plugin_packagekit_resolve_packages_app (GsPlugin *plugin,
        }
 }
 
-/**
- * gs_plugin_packagekit_resolve_packages:
- **/
 static gboolean
 gs_plugin_packagekit_resolve_packages (GsPlugin *plugin,
                                       GsAppList *list,
@@ -350,7 +329,7 @@ gs_plugin_packagekit_refine_from_desktop (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
+/*
  * gs_plugin_packagekit_fixup_update_description:
  *
  * Lets assume Fedora is sending us valid markdown, but fall back to
@@ -377,9 +356,6 @@ gs_plugin_packagekit_fixup_update_description (const gchar *text)
        return g_strdup (text);
 }
 
-/**
- * gs_plugin_packagekit_refine_updatedetails:
- */
 static gboolean
 gs_plugin_packagekit_refine_updatedetails (GsPlugin *plugin,
                                           GsAppList *list,
@@ -439,7 +415,7 @@ gs_plugin_packagekit_refine_updatedetails (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
+/*
  * gs_pk_compare_ids:
  *
  * Do not compare the repo. Some backends do not append the origin.
@@ -462,9 +438,6 @@ gs_pk_compare_ids (const gchar *package_id1, const gchar *package_id2)
        return ret;
 }
 
-/**
- * gs_plugin_packagekit_refine_details_app:
- */
 static void
 gs_plugin_packagekit_refine_details_app (GsPlugin *plugin,
                                         GPtrArray *array,
@@ -519,9 +492,6 @@ gs_plugin_packagekit_refine_details_app (GsPlugin *plugin,
        }
 }
 
-/**
- * gs_plugin_packagekit_refine_details:
- */
 static gboolean
 gs_plugin_packagekit_refine_details (GsPlugin *plugin,
                                     GsAppList *list,
@@ -571,9 +541,6 @@ gs_plugin_packagekit_refine_details (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_packagekit_refine_update_urgency:
- */
 static gboolean
 gs_plugin_packagekit_refine_update_urgency (GsPlugin *plugin,
                                            GsAppList *list,
@@ -640,9 +607,6 @@ gs_plugin_packagekit_refine_update_urgency (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_app_needs_details:
- */
 static gboolean
 gs_plugin_refine_app_needs_details (GsPlugin *plugin, GsPluginRefineFlags flags, GsApp *app)
 {
@@ -661,9 +625,6 @@ gs_plugin_refine_app_needs_details (GsPlugin *plugin, GsPluginRefineFlags flags,
        return FALSE;
 }
 
-/**
- * gs_plugin_refine_require_details:
- */
 static gboolean
 gs_plugin_refine_require_details (GsPlugin *plugin,
                                  GsAppList *list,
@@ -703,9 +664,6 @@ gs_plugin_refine_require_details (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_requires_version:
- */
 static gboolean
 gs_plugin_refine_requires_version (GsApp *app, GsPluginRefineFlags flags)
 {
@@ -716,9 +674,6 @@ gs_plugin_refine_requires_version (GsApp *app, GsPluginRefineFlags flags)
        return (flags & GS_PLUGIN_REFINE_FLAGS_REQUIRE_VERSION) > 0;
 }
 
-/**
- * gs_plugin_refine_requires_update_details:
- */
 static gboolean
 gs_plugin_refine_requires_update_details (GsApp *app, GsPluginRefineFlags flags)
 {
@@ -729,9 +684,6 @@ gs_plugin_refine_requires_update_details (GsApp *app, GsPluginRefineFlags flags)
        return (flags & GS_PLUGIN_REFINE_FLAGS_REQUIRE_UPDATE_DETAILS) > 0;
 }
 
-/**
- * gs_plugin_refine_requires_origin:
- */
 static gboolean
 gs_plugin_refine_requires_origin (GsApp *app, GsPluginRefineFlags flags)
 {
@@ -744,9 +696,6 @@ gs_plugin_refine_requires_origin (GsApp *app, GsPluginRefineFlags flags)
        return FALSE;
 }
 
-/**
- * gs_plugin_refine_requires_package_id:
- */
 static gboolean
 gs_plugin_refine_requires_package_id (GsApp *app, GsPluginRefineFlags flags)
 {
@@ -773,9 +722,6 @@ gs_plugin_refine_requires_package_id (GsApp *app, GsPluginRefineFlags flags)
        return FALSE;
 }
 
-/**
- * gs_plugin_packagekit_refine_distro_upgrade:
- **/
 static gboolean
 gs_plugin_packagekit_refine_distro_upgrade (GsPlugin *plugin,
                                            GsApp *app,
@@ -817,9 +763,6 @@ gs_plugin_packagekit_refine_distro_upgrade (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine:
- */
 gboolean
 gs_plugin_refine (GsPlugin *plugin,
                  GsAppList *list,
diff --git a/src/plugins/gs-plugin-packagekit-refresh.c b/src/plugins/gs-plugin-packagekit-refresh.c
index 7d461f5..114e21d 100644
--- a/src/plugins/gs-plugin-packagekit-refresh.c
+++ b/src/plugins/gs-plugin-packagekit-refresh.c
@@ -37,9 +37,6 @@ struct GsPluginData {
        PkTask                  *task;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -53,9 +50,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_CONFLICTS, "dpkg");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -68,9 +62,6 @@ typedef struct {
        AsProfileTask   *ptask;
 } ProgressData;
 
-/**
- * gs_plugin_packagekit_progress_cb:
- **/
 static void
 gs_plugin_packagekit_progress_cb (PkProgress *progress,
                                  PkProgressType type,
@@ -100,9 +91,6 @@ gs_plugin_packagekit_progress_cb (PkProgress *progress,
                gs_plugin_status_update (plugin, NULL, plugin_status);
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
diff --git a/src/plugins/gs-plugin-packagekit-upgrade.c b/src/plugins/gs-plugin-packagekit-upgrade.c
index 0759e01..1d01ade 100644
--- a/src/plugins/gs-plugin-packagekit-upgrade.c
+++ b/src/plugins/gs-plugin-packagekit-upgrade.c
@@ -32,9 +32,6 @@ struct GsPluginData {
        PkTask                  *task;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -46,9 +43,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        pk_client_set_interactive (PK_CLIENT (priv->task), FALSE);
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -61,9 +55,6 @@ typedef struct {
        GsPlugin        *plugin;
 } ProgressData;
 
-/**
- * gs_plugin_packagekit_progress_cb:
- **/
 static void
 gs_plugin_packagekit_progress_cb (PkProgress *progress,
                                  PkProgressType type,
@@ -84,9 +75,6 @@ gs_plugin_packagekit_progress_cb (PkProgress *progress,
        }
 }
 
-/**
- * gs_plugin_app_upgrade_download:
- */
 gboolean
 gs_plugin_app_upgrade_download (GsPlugin *plugin,
                                GsApp *app,
diff --git a/src/plugins/gs-plugin-packagekit.c b/src/plugins/gs-plugin-packagekit.c
index 176225a..8aa9efd 100644
--- a/src/plugins/gs-plugin-packagekit.c
+++ b/src/plugins/gs-plugin-packagekit.c
@@ -41,9 +41,6 @@ struct GsPluginData {
        PkTask                  *task;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -54,9 +51,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        pk_client_set_cache_age (PK_CLIENT (priv->task), G_MAXUINT);
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -70,9 +64,6 @@ typedef struct {
        AsProfileTask   *ptask;
 } ProgressData;
 
-/**
- * gs_plugin_packagekit_progress_cb:
- **/
 static void
 gs_plugin_packagekit_progress_cb (PkProgress *progress,
                                  PkProgressType type,
@@ -107,9 +98,6 @@ gs_plugin_packagekit_progress_cb (PkProgress *progress,
        }
 }
 
-/**
- * gs_plugin_add_installed:
- */
 gboolean
 gs_plugin_add_installed (GsPlugin *plugin,
                         GsAppList *list,
@@ -147,9 +135,6 @@ gs_plugin_add_installed (GsPlugin *plugin,
        return gs_plugin_packagekit_add_results (plugin, list, results, error);
 }
 
-/**
- * gs_plugin_add_sources_related:
- */
 static gboolean
 gs_plugin_add_sources_related (GsPlugin *plugin,
                               GHashTable *hash,
@@ -209,9 +194,6 @@ gs_plugin_add_sources_related (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_sources:
- */
 gboolean
 gs_plugin_add_sources (GsPlugin *plugin,
                       GsAppList *list,
@@ -271,9 +253,6 @@ gs_plugin_add_sources (GsPlugin *plugin,
        return gs_plugin_add_sources_related (plugin, hash, cancellable, error);
 }
 
-/**
- * gs_plugin_app_source_enable:
- */
 static gboolean
 gs_plugin_app_source_enable (GsPlugin *plugin,
                             GsApp *app,
@@ -301,9 +280,6 @@ gs_plugin_app_source_enable (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_install:
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin,
                       GsApp *app,
@@ -480,9 +456,6 @@ gs_plugin_app_install (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_source_disable:
- */
 static gboolean
 gs_plugin_app_source_disable (GsPlugin *plugin,
                              GsApp *app,
@@ -510,9 +483,6 @@ gs_plugin_app_source_disable (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_source_remove:
- */
 static gboolean
 gs_plugin_app_source_remove (GsPlugin *plugin,
                             GsApp *app,
@@ -547,9 +517,6 @@ gs_plugin_app_source_remove (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_remove:
- */
 gboolean
 gs_plugin_app_remove (GsPlugin *plugin,
                      GsApp *app,
@@ -626,9 +593,6 @@ gs_plugin_app_remove (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_search_files:
- */
 gboolean
 gs_plugin_add_search_files (GsPlugin *plugin,
                             gchar **search,
@@ -663,9 +627,6 @@ gs_plugin_add_search_files (GsPlugin *plugin,
        return gs_plugin_packagekit_add_results (plugin, list, results, error);
 }
 
-/**
- * gs_plugin_add_search_what_provides:
- */
 gboolean
 gs_plugin_add_search_what_provides (GsPlugin *plugin,
                                     gchar **search,
@@ -700,9 +661,6 @@ gs_plugin_add_search_what_provides (GsPlugin *plugin,
        return gs_plugin_packagekit_add_results (plugin, list, results, error);
 }
 
-/**
- * gs_plugin_launch:
- */
 gboolean
 gs_plugin_launch (GsPlugin *plugin,
                  GsApp *app,
diff --git a/src/plugins/gs-plugin-provenance-license.c b/src/plugins/gs-plugin-provenance-license.c
index 387ca4e..ec24fca 100644
--- a/src/plugins/gs-plugin-provenance-license.c
+++ b/src/plugins/gs-plugin-provenance-license.c
@@ -36,9 +36,6 @@ struct GsPluginData {
        gchar                   *license_id;
 };
 
-/**
- * gs_plugin_provenance_license_get_sources:
- */
 static gchar **
 gs_plugin_provenance_license_get_sources (GsPlugin *plugin)
 {
@@ -53,9 +50,6 @@ gs_plugin_provenance_license_get_sources (GsPlugin *plugin)
        return g_settings_get_strv (priv->settings, "free-sources");
 }
 
-/**
- * gs_plugin_provenance_license_get_id:
- */
 static gchar *
 gs_plugin_provenance_license_get_id (GsPlugin *plugin)
 {
@@ -75,9 +69,6 @@ gs_plugin_provenance_license_get_id (GsPlugin *plugin)
        return g_strdup_printf ("LicenseRef-free=%s", url);
 }
 
-/**
- * gs_plugin_provenance_license_changed_cb:
- */
 static void
 gs_plugin_provenance_license_changed_cb (GSettings *settings,
                                         const gchar *key,
@@ -94,9 +85,6 @@ gs_plugin_provenance_license_changed_cb (GSettings *settings,
        }
 }
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -111,9 +99,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "provenance");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -123,9 +108,6 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_object_unref (priv->settings);
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-provenance.c b/src/plugins/gs-plugin-provenance.c
index f634c7f..e72779a 100644
--- a/src/plugins/gs-plugin-provenance.c
+++ b/src/plugins/gs-plugin-provenance.c
@@ -34,9 +34,6 @@ struct GsPluginData {
        gchar                   **sources;
 };
 
-/**
- * gs_plugin_provenance_get_sources:
- */
 static gchar **
 gs_plugin_provenance_get_sources (GsPlugin *plugin)
 {
@@ -50,9 +47,6 @@ gs_plugin_provenance_get_sources (GsPlugin *plugin)
        return g_settings_get_strv (priv->settings, "official-sources");
 }
 
-/**
- * gs_plugin_provenance_settings_changed_cb:
- */
 static void
 gs_plugin_provenance_settings_changed_cb (GSettings *settings,
                                          const gchar *key,
@@ -65,9 +59,6 @@ gs_plugin_provenance_settings_changed_cb (GSettings *settings,
        }
 }
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -82,9 +73,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "packagekit-refine");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -93,9 +81,6 @@ gs_plugin_destroy (GsPlugin *plugin)
        g_object_unref (priv->settings);
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-rpm.c b/src/plugins/gs-plugin-rpm.c
index 2bf9788..974d8b0 100644
--- a/src/plugins/gs-plugin-rpm.c
+++ b/src/plugins/gs-plugin-rpm.c
@@ -28,9 +28,6 @@
 
 #include <gnome-software.h>
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -50,9 +47,6 @@ gs_plugin_initialize (GsPlugin *plugin)
 G_DEFINE_AUTO_CLEANUP_FREE_FUNC(rpmts, rpmtsFree, NULL);
 G_DEFINE_AUTO_CLEANUP_FREE_FUNC(rpmdbMatchIterator, rpmdbFreeIterator, NULL);
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
diff --git a/src/plugins/gs-plugin-shell-extensions.c b/src/plugins/gs-plugin-shell-extensions.c
index 53cfabd..26751fe 100644
--- a/src/plugins/gs-plugin-shell-extensions.c
+++ b/src/plugins/gs-plugin-shell-extensions.c
@@ -62,18 +62,12 @@ typedef enum {
        GS_PLUGIN_SHELL_EXTENSION_KIND_LAST
 } GsPluginShellExtensionKind;
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
        gs_plugin_alloc_data (plugin, sizeof(GsPluginData));
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -83,9 +77,6 @@ gs_plugin_destroy (GsPlugin *plugin)
                g_object_unref (priv->proxy);
 }
 
-/**
- * gs_plugin_adopt_app:
- */
 void
 gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
 {
@@ -93,18 +84,12 @@ gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
                gs_app_set_management_plugin (app, gs_plugin_get_name (plugin));
 }
 
-/**
- * gs_plugin_shell_extensions_id_from_uuid:
- */
 static gchar *
 gs_plugin_shell_extensions_id_from_uuid (const gchar *uuid)
 {
        return g_strdup_printf ("%s.shell-extension", uuid);
 }
 
-/**
- * gs_plugin_shell_extensions_add_app:
- */
 static GsApp *
 gs_plugin_shell_extensions_add_app (const gchar *uuid,
                                    GVariantIter *iter,
@@ -222,9 +207,6 @@ gs_plugin_shell_extensions_add_app (const gchar *uuid,
        return g_steal_pointer (&app);
 }
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -250,9 +232,6 @@ gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_add_installed:
- */
 gboolean
 gs_plugin_add_installed (GsPlugin *plugin,
                         GsAppList *list,
@@ -294,9 +273,6 @@ gs_plugin_add_installed (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
@@ -325,9 +301,6 @@ gs_plugin_refine_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_shell_extensions_parse_version:
- */
 static gboolean
 gs_plugin_shell_extensions_parse_version (GsPlugin *plugin,
                                          AsApp *app,
@@ -384,9 +357,6 @@ gs_plugin_shell_extensions_parse_version (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_shell_extensions_parse_app:
- */
 static AsApp *
 gs_plugin_shell_extensions_parse_app (GsPlugin *plugin,
                                      JsonObject *json_app,
@@ -482,9 +452,6 @@ gs_plugin_shell_extensions_parse_app (GsPlugin *plugin,
        return app;
 }
 
-/**
- * gs_plugin_shell_extensions_parse_apps:
- */
 static GPtrArray *
 gs_plugin_shell_extensions_parse_apps (GsPlugin *plugin,
                                       const gchar *data,
@@ -573,9 +540,6 @@ gs_plugin_shell_extensions_parse_apps (GsPlugin *plugin,
        return apps;
 }
 
-/**
- * gs_plugin_shell_extensions_get_apps:
- */
 static GPtrArray *
 gs_plugin_shell_extensions_get_apps (GsPlugin *plugin,
                                     guint cache_age,
@@ -643,9 +607,6 @@ gs_plugin_shell_extensions_get_apps (GsPlugin *plugin,
        return apps;
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
@@ -708,9 +669,6 @@ gs_plugin_refresh (GsPlugin *plugin,
                                 error);
 }
 
-/**
- * gs_plugin_app_remove:
- */
 gboolean
 gs_plugin_app_remove (GsPlugin *plugin,
                      GsApp *app,
@@ -760,9 +718,6 @@ gs_plugin_app_remove (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_install:
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin,
                       GsApp *app,
@@ -812,9 +767,6 @@ gs_plugin_app_install (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_launch:
- */
 gboolean
 gs_plugin_launch (GsPlugin *plugin,
                  GsApp *app,
@@ -851,9 +803,6 @@ gs_plugin_launch (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_categories:
- */
 gboolean
 gs_plugin_add_categories (GsPlugin *plugin,
                          GPtrArray *list,
diff --git a/src/plugins/gs-plugin-steam.c b/src/plugins/gs-plugin-steam.c
index 6bd6dc1..4073ade 100644
--- a/src/plugins/gs-plugin-steam.c
+++ b/src/plugins/gs-plugin-steam.c
@@ -26,9 +26,6 @@
 
 #define GS_PLUGIN_STEAM_SCREENSHOT_URI "http://cdn.akamai.steamstatic.com/steam/apps";
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -44,9 +41,6 @@ typedef enum {
        GS_PLUGIN_STEAM_TOKEN_LAST,
 } GsPluginSteamToken;
 
-/**
- * gs_plugin_steam_token_kind_to_str:
- **/
 static const gchar *
 gs_plugin_steam_token_kind_to_str (guint8 data)
 {
@@ -83,9 +77,6 @@ gs_plugin_steam_token_kind_to_str (guint8 data)
        return "[?]";
 }
 
-/**
- * gs_plugin_steam_consume_uint32:
- **/
 static guint32
 gs_plugin_steam_consume_uint32 (guint8 *data, gsize data_len, guint *idx)
 {
@@ -94,9 +85,6 @@ gs_plugin_steam_consume_uint32 (guint8 *data, gsize data_len, guint *idx)
        return tmp;
 }
 
-/**
- * gs_plugin_steam_consume_string:
- **/
 static const gchar *
 gs_plugin_steam_consume_string (guint8 *data, gsize data_len, guint *idx)
 {
@@ -112,9 +100,6 @@ gs_plugin_steam_consume_string (guint8 *data, gsize data_len, guint *idx)
        return tmp;
 }
 
-/**
- * gs_plugin_steam_find_next_sync_point:
- **/
 static void
 gs_plugin_steam_find_next_sync_point (guint8 *data, gsize data_len, guint *idx)
 {
@@ -128,9 +113,6 @@ gs_plugin_steam_find_next_sync_point (guint8 *data, gsize data_len, guint *idx)
        *idx = 0xfffffffe;
 }
 
-/**
- * gs_plugin_steam_add_app:
- **/
 static GHashTable *
 gs_plugin_steam_add_app (GPtrArray *apps)
 {
@@ -141,9 +123,6 @@ gs_plugin_steam_add_app (GPtrArray *apps)
        return app;
 }
 
-/**
- * gs_plugin_steam_parse_appinfo_file:
- **/
 static GPtrArray *
 gs_plugin_steam_parse_appinfo_file (const gchar *filename, GError **error)
 {
@@ -231,9 +210,6 @@ gs_plugin_steam_parse_appinfo_file (const gchar *filename, GError **error)
        return apps;
 }
 
-/**
- * gs_plugin_steam_dump_apps:
- **/
 static void
 gs_plugin_steam_dump_apps (GPtrArray *apps)
 {
@@ -259,7 +235,7 @@ gs_plugin_steam_dump_apps (GPtrArray *apps)
        }
 }
 
-/**
+/*
  * gs_plugin_steam_capture:
  *
  * Returns: A string between @start and @end, or %NULL
@@ -297,9 +273,6 @@ gs_plugin_steam_capture (const gchar *html,
        return NULL;
 }
 
-/**
- * gs_plugin_steam_update_screenshots:
- **/
 static gboolean
 gs_plugin_steam_update_screenshots (AsApp *app, const gchar *html, GError **error)
 {
@@ -337,9 +310,6 @@ gs_plugin_steam_update_screenshots (AsApp *app, const gchar *html, GError **erro
        return TRUE;
 }
 
-/**
- * gs_plugin_steam_update_description:
- **/
 static gboolean
 gs_plugin_steam_update_description (AsApp *app,
                                    const gchar *html,
@@ -384,9 +354,6 @@ gs_plugin_steam_update_description (AsApp *app,
        return TRUE;
 }
 
-/**
- * gs_plugin_steam_download_icon:
- **/
 static gboolean
 gs_plugin_steam_download_icon (GsPlugin *plugin,
                               AsApp *app,
@@ -460,9 +427,6 @@ gs_plugin_steam_download_icon (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_steam_update_store_app:
- **/
 static gboolean
 gs_plugin_steam_update_store_app (GsPlugin *plugin,
                                  AsStore *store,
@@ -642,9 +606,6 @@ gs_plugin_steam_update_store_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_steam_update_store:
- */
 static gboolean
 gs_plugin_steam_update_store (GsPlugin *plugin, AsStore *store, GPtrArray *apps, GError **error)
 {
@@ -664,9 +625,6 @@ gs_plugin_steam_update_store (GsPlugin *plugin, AsStore *store, GPtrArray *apps,
        return TRUE;
 }
 
-/**
- * gs_plugin_steam_refresh:
- */
 static gboolean
 gs_plugin_steam_refresh (GsPlugin *plugin,
                         guint cache_age,
@@ -730,9 +688,6 @@ gs_plugin_steam_refresh (GsPlugin *plugin,
                                 error);
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
@@ -743,9 +698,6 @@ gs_plugin_refresh (GsPlugin *plugin,
        return gs_plugin_steam_refresh (plugin, cache_age, cancellable, error);
 }
 
-/**
- * gs_plugin_steam_load_app_manifest:
- */
 static GHashTable *
 gs_plugin_steam_load_app_manifest (const gchar *fn, GError **error)
 {
@@ -817,9 +769,6 @@ typedef enum {
        GS_STEAM_STATE_FLAG_LAST
 } GsSteamStateFlags;
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
@@ -912,9 +861,6 @@ gs_plugin_refine_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_install:
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin, GsApp *app,
                       GCancellable *cancellable, GError **error)
@@ -934,9 +880,6 @@ gs_plugin_app_install (GsPlugin *plugin, GsApp *app,
        return g_spawn_command_line_sync (cmdline, NULL, NULL, NULL, error);
 }
 
-/**
- * gs_plugin_app_remove:
- */
 gboolean
 gs_plugin_app_remove (GsPlugin *plugin, GsApp *app,
                      GCancellable *cancellable, GError **error)
@@ -956,9 +899,6 @@ gs_plugin_app_remove (GsPlugin *plugin, GsApp *app,
        return g_spawn_command_line_sync (cmdline, NULL, NULL, NULL, error);
 }
 
-/**
- * gs_plugin_launch:
- */
 gboolean
 gs_plugin_launch (GsPlugin *plugin, GsApp *app,
                  GCancellable *cancellable, GError **error)
@@ -977,9 +917,6 @@ gs_plugin_launch (GsPlugin *plugin, GsApp *app,
        return g_spawn_command_line_sync (cmdline, NULL, NULL, NULL, error);
 }
 
-/**
- * gs_plugin_add_search:
- */
 gboolean
 gs_plugin_add_search (GsPlugin *plugin,
                      gchar **values,
diff --git a/src/plugins/gs-plugin-systemd-updates.c b/src/plugins/gs-plugin-systemd-updates.c
index 67bdfe5..bfd3bb1 100644
--- a/src/plugins/gs-plugin-systemd-updates.c
+++ b/src/plugins/gs-plugin-systemd-updates.c
@@ -36,18 +36,12 @@ struct GsPluginData {
        GFileMonitor            *monitor;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
        gs_plugin_alloc_data (plugin, sizeof(GsPluginData));
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -56,9 +50,6 @@ gs_plugin_destroy (GsPlugin *plugin)
                g_object_unref (priv->monitor);
 }
 
-/**
- * gs_plugin_systemd_updates_changed_cb:
- */
 static void
 gs_plugin_systemd_updates_changed_cb (GFileMonitor *monitor,
                                      GFile *file, GFile *other_file,
@@ -69,9 +60,6 @@ gs_plugin_systemd_updates_changed_cb (GFileMonitor *monitor,
        gs_plugin_updates_changed (plugin);
 }
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -85,9 +73,6 @@ gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_add_updates:
- */
 gboolean
 gs_plugin_add_updates (GsPlugin *plugin,
                       GsAppList *list,
@@ -132,9 +117,6 @@ gs_plugin_add_updates (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_update:
- */
 gboolean
 gs_plugin_update (GsPlugin *plugin,
                  GsAppList *apps,
@@ -159,9 +141,6 @@ gs_plugin_update (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_update_cancel:
- */
 gboolean
 gs_plugin_update_cancel (GsPlugin *plugin,
                         GsApp *app,
@@ -174,9 +153,6 @@ gs_plugin_update_cancel (GsPlugin *plugin,
        return pk_offline_cancel (NULL, error);
 }
 
-/**
- * gs_plugin_app_upgrade_trigger:
- */
 gboolean
 gs_plugin_app_upgrade_trigger (GsPlugin *plugin,
                                GsApp *app,
diff --git a/src/plugins/gs-plugin-xdg-app.c b/src/plugins/gs-plugin-xdg-app.c
index b5084f3..85cd7de 100644
--- a/src/plugins/gs-plugin-xdg-app.c
+++ b/src/plugins/gs-plugin-xdg-app.c
@@ -47,9 +47,6 @@ struct GsPluginData {
        GFileMonitor            *monitor;
 };
 
-/**
- * gs_plugin_initialize:
- */
 void
 gs_plugin_initialize (GsPlugin *plugin)
 {
@@ -59,9 +56,6 @@ gs_plugin_initialize (GsPlugin *plugin)
        gs_plugin_add_rule (plugin, GS_PLUGIN_RULE_RUN_AFTER, "appstream");
 }
 
-/**
- * gs_plugin_destroy:
- */
 void
 gs_plugin_destroy (GsPlugin *plugin)
 {
@@ -72,9 +66,6 @@ gs_plugin_destroy (GsPlugin *plugin)
                g_object_unref (priv->monitor);
 }
 
-/**
- * gs_plugin_adopt_app:
- */
 void
 gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
 {
@@ -95,9 +86,6 @@ gs_plugin_adopt_app (GsPlugin *plugin, GsApp *app)
 #define gs_app_set_xdgapp_branch(app,val)      gs_app_set_metadata(app,"xdg-app::branch",val)
 #define gs_app_set_xdgapp_commit(app,val)      gs_app_set_metadata(app,"xdg-app::commit",val)
 
-/**
- * gs_app_get_xdgapp_kind:
- */
 static XdgAppRefKind
 gs_app_get_xdgapp_kind (GsApp *app)
 {
@@ -110,9 +98,6 @@ gs_app_get_xdgapp_kind (GsApp *app)
        return XDG_APP_REF_KIND_APP;
 }
 
-/**
- * gs_app_set_xdgapp_kind:
- */
 static void
 gs_app_set_xdgapp_kind (GsApp *app, XdgAppRefKind kind)
 {
@@ -125,9 +110,6 @@ gs_app_set_xdgapp_kind (GsApp *app, XdgAppRefKind kind)
 }
 
 #ifndef HAVE_PACKAGEKIT
-/**
- * gs_plugin_add_popular:
- */
 gboolean
 gs_plugin_add_popular (GsPlugin *plugin,
                       GsAppList *list,
@@ -157,9 +139,6 @@ gs_plugin_add_popular (GsPlugin *plugin,
 }
 #endif
 
-/**
- * gs_plugin_xdg_app_changed_cb:
- */
 static void
 gs_plugin_xdg_app_changed_cb (GFileMonitor *monitor,
                              GFile *child,
@@ -170,9 +149,6 @@ gs_plugin_xdg_app_changed_cb (GFileMonitor *monitor,
        gs_plugin_updates_changed (plugin);
 }
 
-/**
- * gs_plugin_refresh_appstream:
- */
 static gboolean
 gs_plugin_refresh_appstream (GsPlugin *plugin,
                             guint cache_age,
@@ -244,9 +220,6 @@ gs_plugin_refresh_appstream (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_setup:
- */
 gboolean
 gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
 {
@@ -290,9 +263,6 @@ gs_plugin_setup (GsPlugin *plugin, GCancellable *cancellable, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_xdg_app_set_metadata:
- */
 static void
 gs_plugin_xdg_app_set_metadata (GsApp *app, XdgAppRef *xref)
 {
@@ -304,9 +274,6 @@ gs_plugin_xdg_app_set_metadata (GsApp *app, XdgAppRef *xref)
        gs_app_set_xdgapp_commit (app, xdg_app_ref_get_commit (xref));
 }
 
-/**
- * gs_plugin_xdg_app_set_metadata_installed:
- */
 static void
 gs_plugin_xdg_app_set_metadata_installed (GsApp *app, XdgAppInstalledRef *xref)
 {
@@ -343,9 +310,6 @@ gs_plugin_xdg_app_set_metadata_installed (GsApp *app, XdgAppInstalledRef *xref)
                gs_app_set_size_installed (app, size_installed);
 }
 
-/**
- * gs_plugin_xdg_app_build_id:
- */
 static gchar *
 gs_plugin_xdg_app_build_id (XdgAppRef *xref)
 {
@@ -354,9 +318,6 @@ gs_plugin_xdg_app_build_id (XdgAppRef *xref)
        return g_strdup_printf ("user-xdgapp:%s.runtime", xdg_app_ref_get_name (xref));
 }
 
-/**
- * gs_plugin_xdg_app_create_installed:
- */
 static GsApp *
 gs_plugin_xdg_app_create_installed (GsPlugin *plugin,
                                    XdgAppInstalledRef *xref,
@@ -418,9 +379,6 @@ gs_plugin_xdg_app_create_installed (GsPlugin *plugin,
        return g_object_ref (app);
 }
 
-/**
- * gs_plugin_xdg_app_progress_cb:
- */
 static void
 gs_plugin_xdg_app_progress_cb (const gchar *status,
                               guint progress,
@@ -431,9 +389,6 @@ gs_plugin_xdg_app_progress_cb (const gchar *status,
        gs_app_set_progress (app, progress);
 }
 
-/**
- * gs_plugin_add_installed:
- */
 gboolean
 gs_plugin_add_installed (GsPlugin *plugin,
                         GsAppList *list,
@@ -480,9 +435,6 @@ gs_plugin_add_installed (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_sources:
- */
 gboolean
 gs_plugin_add_sources (GsPlugin *plugin,
                       GsAppList *list,
@@ -525,9 +477,6 @@ gs_plugin_add_sources (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_add_updates:
- */
 gboolean
 gs_plugin_add_updates (GsPlugin *plugin,
                       GsAppList *list,
@@ -578,9 +527,6 @@ gs_plugin_add_updates (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refresh:
- */
 gboolean
 gs_plugin_refresh (GsPlugin *plugin,
                   guint cache_age,
@@ -635,9 +581,6 @@ gs_plugin_refresh (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_origin_ui:
- */
 static gboolean
 gs_plugin_refine_item_origin_ui (GsPlugin *plugin,
                                 GsApp *app,
@@ -675,9 +618,6 @@ gs_plugin_refine_item_origin_ui (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_origin:
- */
 static gboolean
 gs_plugin_refine_item_origin (GsPlugin *plugin,
                              GsApp *app,
@@ -739,9 +679,6 @@ gs_plugin_refine_item_origin (GsPlugin *plugin,
        return FALSE;
 }
 
-/**
- * gs_plugin_refine_item_commit:
- */
 static gboolean
 gs_plugin_refine_item_commit (GsPlugin *plugin,
                              GsApp *app,
@@ -776,9 +713,6 @@ gs_plugin_refine_item_commit (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_xdg_app_is_xref:
- */
 static gboolean
 gs_plugin_xdg_app_is_xref (GsApp *app, XdgAppRef *xref)
 {
@@ -806,9 +740,6 @@ gs_plugin_xdg_app_is_xref (GsApp *app, XdgAppRef *xref)
        return FALSE;
 }
 
-/**
- * gs_plugin_refine_item_metadata:
- */
 static gboolean
 gs_plugin_refine_item_metadata (GsPlugin *plugin,
                                GsApp *app,
@@ -841,9 +772,6 @@ gs_plugin_refine_item_metadata (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_state:
- */
 static gboolean
 gs_plugin_refine_item_state (GsPlugin *plugin,
                              GsApp *app,
@@ -903,9 +831,6 @@ gs_plugin_refine_item_state (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_xdg_app_set_app_metadata:
- */
 static gboolean
 gs_plugin_xdg_app_set_app_metadata (GsApp *app,
                                    const gchar *data,
@@ -938,9 +863,6 @@ gs_plugin_xdg_app_set_app_metadata (GsApp *app,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_runtime:
- */
 static gboolean
 gs_plugin_refine_item_runtime (GsPlugin *plugin,
                               GsApp *app,
@@ -1005,9 +927,6 @@ gs_plugin_refine_item_runtime (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_item_size:
- */
 static gboolean
 gs_plugin_refine_item_size (GsPlugin *plugin,
                            GsApp *app,
@@ -1086,9 +1005,6 @@ gs_plugin_refine_item_size (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_xdg_app_refine_app:
- */
 static gboolean
 gs_plugin_xdg_app_refine_app (GsPlugin *plugin,
                              GsApp *app,
@@ -1140,9 +1056,6 @@ gs_plugin_xdg_app_refine_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_refine_app:
- */
 gboolean
 gs_plugin_refine_app (GsPlugin *plugin,
                      GsApp *app,
@@ -1152,9 +1065,6 @@ gs_plugin_refine_app (GsPlugin *plugin,
 {      return gs_plugin_xdg_app_refine_app (plugin, app, flags, cancellable, error);
 }
 
-/**
- * gs_plugin_launch:
- */
 gboolean
 gs_plugin_launch (GsPlugin *plugin,
                  GsApp *app,
@@ -1181,9 +1091,6 @@ gs_plugin_launch (GsPlugin *plugin,
                                            error);
 }
 
-/**
- * gs_plugin_app_remove:
- */
 gboolean
 gs_plugin_app_remove (GsPlugin *plugin,
                      GsApp *app,
@@ -1215,9 +1122,6 @@ gs_plugin_app_remove (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_app_install:
- */
 gboolean
 gs_plugin_app_install (GsPlugin *plugin,
                       GsApp *app,
@@ -1312,9 +1216,6 @@ gs_plugin_app_install (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_update_app:
- */
 gboolean
 gs_plugin_update_app (GsPlugin *plugin,
                      GsApp *app,
@@ -1349,9 +1250,6 @@ gs_plugin_update_app (GsPlugin *plugin,
        return TRUE;
 }
 
-/**
- * gs_plugin_file_to_app:
- */
 gboolean
 gs_plugin_file_to_app (GsPlugin *plugin,
                       GsAppList *list,
diff --git a/src/plugins/menu-spec-common.c b/src/plugins/menu-spec-common.c
index cbb57dc..1010f0c 100644
--- a/src/plugins/menu-spec-common.c
+++ b/src/plugins/menu-spec-common.c
@@ -217,9 +217,6 @@ static const MenuSpecData msdata[] = {
        { NULL,                                 NULL, NULL }
 };
 
-/**
- * menu_spec_get_data:
- */
 const MenuSpecData *
 menu_spec_get_data (void)
 {
diff --git a/src/plugins/packagekit-common.c b/src/plugins/packagekit-common.c
index 17a2e37..0a1ceeb 100644
--- a/src/plugins/packagekit-common.c
+++ b/src/plugins/packagekit-common.c
@@ -28,9 +28,6 @@
 
 #include "packagekit-common.h"
 
-/**
- * packagekit_status_enum_to_plugin_status:
- **/
 GsPluginStatus
 packagekit_status_enum_to_plugin_status (PkStatusEnum status)
 {
@@ -84,9 +81,6 @@ packagekit_status_enum_to_plugin_status (PkStatusEnum status)
        return plugin_status;
 }
 
-/**
- * gs_plugin_packagekit_convert_gerror:
- */
 gboolean
 gs_plugin_packagekit_convert_gerror (GError **error)
 {
@@ -156,9 +150,6 @@ gs_plugin_packagekit_convert_gerror (GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_packagekit_results_valid:
- */
 gboolean
 gs_plugin_packagekit_results_valid (PkResults *results, GError **error)
 {
@@ -184,9 +175,6 @@ gs_plugin_packagekit_results_valid (PkResults *results, GError **error)
        return TRUE;
 }
 
-/**
- * gs_plugin_packagekit_add_results:
- */
 gboolean
 gs_plugin_packagekit_add_results (GsPlugin *plugin,
                                  GsAppList *list,



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]