Remove @internal

18 files changed, 34 insertions, 44 deletions

diff --git a/finch/libgnt/gnt.h b/finch/libgnt/gnt.h
index b9452e3d0a..ea26c08749 100644
--- a/finch/libgnt/gnt.h
+++ b/finch/libgnt/gnt.h
@@ -72,24 +72,24 @@ void gnt_window_present(GntWidget *window);
 /**
  * gnt_screen_occupy:
  *
- * @internal
- * Use #gnt_widget_show instead.
+ * Internal function -- do not use.
+ * Use gnt_widget_show() instead.
  */
 void gnt_screen_occupy(GntWidget *widget);
 
 /**
  * gnt_screen_release:
  *
- * @internal
- * Use #gnt_widget_hide instead.
+ * Internal function -- do not use.
+ * Use gnt_widget_hide() instead.
  */
 void gnt_screen_release(GntWidget *widget);
 
 /**
  * gnt_screen_update:
  *
- * @internal
- * Use #gnt_widget_draw instead.
+ * Internal function -- do not use.
+ * Use gnt_widget_draw() instead.
  */
 void gnt_screen_update(GntWidget *widget);
 
diff --git a/finch/libgnt/gntstyle.h b/finch/libgnt/gntstyle.h
index 186ff39382..21dbfc689e 100644
--- a/finch/libgnt/gntstyle.h
+++ b/finch/libgnt/gntstyle.h
@@ -128,14 +128,14 @@ gboolean gnt_style_get_bool(GntStyle style, gboolean def);
 /**
  * gnt_styles_get_keyremaps:
  *
- * @internal
+ * Internal function -- do not use.
  */
 void gnt_styles_get_keyremaps(GType type, GHashTable *hash);
 
 /**
  * gnt_style_read_actions:
  *
- * @internal
+ * Internal function -- do not use.
  */
 void gnt_style_read_actions(GType type, GntBindableClass *klass);
 
@@ -153,8 +153,9 @@ gboolean gnt_style_read_menu_accels(const char *name, GHashTable *table);
 /**
  * gnt_style_read_workspaces:
  *
- * @internal
- * Read workspace information.
+ * Reads workspace information.
+ *
+ * Internal function -- do not use.
  */
 void gnt_style_read_workspaces(GntWM *wm);
 
diff --git a/finch/libgnt/gntwidget.h b/finch/libgnt/gntwidget.h
index 16357958e3..b3876fecbc 100644
--- a/finch/libgnt/gntwidget.h
+++ b/finch/libgnt/gntwidget.h
@@ -181,8 +181,9 @@ void gnt_widget_draw(GntWidget *widget);
 /**
  * gnt_widget_expose:
  *
- * @internal
  * Expose part of a widget.
+ *
+ * Internal function -- do not use.
  */
 void gnt_widget_expose(GntWidget *widget, int x, int y, int width, int height);
 
@@ -322,8 +323,8 @@ const char *gnt_widget_get_name(GntWidget *widget);
 /**
  * gnt_widget_queue_update:
  *
- * @internal
- * Use #gnt_widget_draw instead.
+ * Internal function -- do not use.
+ * Use gnt_widget_draw() instead.
  */
 void gnt_widget_queue_update(GntWidget *widget);
 
diff --git a/finch/libgnt/gntwm.h b/finch/libgnt/gntwm.h
index 5efaca6cd6..d4d3ab828d 100644
--- a/finch/libgnt/gntwm.h
+++ b/finch/libgnt/gntwm.h
@@ -360,14 +360,14 @@ void gnt_wm_raise_window(GntWM *wm, GntWidget *widget);
 /**
  * gnt_wm_set_event_stack:
  *
- * @internal
+ * Internal function -- do not use.
  */
 void gnt_wm_set_event_stack(GntWM *wm, gboolean set);
 
 /**
  * gnt_wm_copy_win:
  *
- * @internal
+ * Internal function -- do not use.
  */
 void gnt_wm_copy_win(GntWidget *widget, GntNode *node);
 
@@ -379,4 +379,5 @@ void gnt_wm_copy_win(GntWidget *widget, GntNode *node);
 time_t gnt_wm_get_idle_time(void);
 
 G_END_DECLS
+
 #endif
diff --git a/libpurple/smiley.h b/libpurple/smiley.h
index f9e13e2177..b347930e32 100644
--- a/libpurple/smiley.h
+++ b/libpurple/smiley.h
@@ -79,8 +79,7 @@ G_BEGIN_DECLS
 /**
  * purple_smiley_get_type:
  *
- * GObject-fu.
- * @internal.
+ * Returns: The #GType for a smiley.
  */
 GType purple_smiley_get_type(void);
 
diff --git a/libpurple/sound-theme-loader.h b/libpurple/sound-theme-loader.h
index e7d609869e..d951401560 100644
--- a/libpurple/sound-theme-loader.h
+++ b/libpurple/sound-theme-loader.h
@@ -72,8 +72,7 @@ G_BEGIN_DECLS
 /**
  * purple_sound_theme_loader_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for sound theme loader.
  */
 GType purple_sound_theme_loader_get_type(void);
 
diff --git a/libpurple/sound-theme.h b/libpurple/sound-theme.h
index 81a0fbfd71..e63b9f4ea7 100644
--- a/libpurple/sound-theme.h
+++ b/libpurple/sound-theme.h
@@ -74,8 +74,7 @@ G_BEGIN_DECLS
 /**
  * purple_sound_theme_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for a sound theme.
  */
 GType purple_sound_theme_get_type(void);
 
diff --git a/libpurple/theme-loader.h b/libpurple/theme-loader.h
index 6ab04132f0..a7423ca687 100644
--- a/libpurple/theme-loader.h
+++ b/libpurple/theme-loader.h
@@ -76,8 +76,7 @@ G_BEGIN_DECLS
 /**
  * purple_theme_loader_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for theme loader.
  */
 GType purple_theme_loader_get_type(void);
 
diff --git a/libpurple/theme-manager.h b/libpurple/theme-manager.h
index 96a82623c4..41f603bb90 100644
--- a/libpurple/theme-manager.h
+++ b/libpurple/theme-manager.h
@@ -68,9 +68,7 @@ G_BEGIN_DECLS
 /**
  * purple_theme_manager_get_type:
  *
- * GObject foo.
- *
- * @internal.
+ * Returns: The #GType for theme manager.
  */
 GType purple_theme_manager_get_type(void);
 
diff --git a/libpurple/theme.h b/libpurple/theme.h
index 74b1fb8f6e..74b91921ed 100644
--- a/libpurple/theme.h
+++ b/libpurple/theme.h
@@ -72,8 +72,7 @@ G_BEGIN_DECLS
 /**
  * purple_theme_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for a theme.
  */
 GType purple_theme_get_type(void);
 
diff --git a/pidgin/gtkblist-theme-loader.h b/pidgin/gtkblist-theme-loader.h
index 7a7e4c0872..b17a00f982 100644
--- a/pidgin/gtkblist-theme-loader.h
+++ b/pidgin/gtkblist-theme-loader.h
@@ -66,10 +66,10 @@ G_BEGIN_DECLS
 /**
  * pidgin_blist_theme_loader_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for a blist theme loader.
  */
 GType pidgin_blist_theme_loader_get_type(void);
 
 G_END_DECLS
+
 #endif /* PIDGIN_BLIST_THEME_LOADER_H */
diff --git a/pidgin/gtkblist-theme.h b/pidgin/gtkblist-theme.h
index 7ecd70e22a..75f9d28f46 100644
--- a/pidgin/gtkblist-theme.h
+++ b/pidgin/gtkblist-theme.h
@@ -166,8 +166,7 @@ const gchar * pidgin_theme_font_get_color_describe(PidginThemeFont *font);
 /**
  * pidgin_blist_theme_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for a blist theme.
  */
 GType pidgin_blist_theme_get_type(void);
 
diff --git a/pidgin/gtkconv-theme-loader.h b/pidgin/gtkconv-theme-loader.h
index 4c9f979d40..9fd58f5b44 100644
--- a/pidgin/gtkconv-theme-loader.h
+++ b/pidgin/gtkconv-theme-loader.h
@@ -66,11 +66,11 @@ G_BEGIN_DECLS
 /**
  * pidgin_conversation_theme_loader_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for a conversation theme loader.
  */
 GType pidgin_conversation_theme_loader_get_type(void);
 
 G_END_DECLS
+
 #endif /* PIDGIN_CONV_THEME_LOADER_H */
 
diff --git a/pidgin/gtkconv-theme.h b/pidgin/gtkconv-theme.h
index 105a1c3a0f..6f8337d58a 100644
--- a/pidgin/gtkconv-theme.h
+++ b/pidgin/gtkconv-theme.h
@@ -89,8 +89,7 @@ G_BEGIN_DECLS
 /**
  * pidgin_conversation_theme_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for a conversation theme.
  */
 GType pidgin_conversation_theme_get_type(void);
 
diff --git a/pidgin/gtkicon-theme-loader.h b/pidgin/gtkicon-theme-loader.h
index bf829348d9..8409879e9d 100644
--- a/pidgin/gtkicon-theme-loader.h
+++ b/pidgin/gtkicon-theme-loader.h
@@ -66,8 +66,7 @@ G_BEGIN_DECLS
 /**
  * pidgin_icon_theme_loader_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for an icon theme loader.
  */
 GType pidgin_icon_theme_loader_get_type(void);
 
diff --git a/pidgin/gtkicon-theme.h b/pidgin/gtkicon-theme.h
index d68bdd9702..911aa0c44a 100644
--- a/pidgin/gtkicon-theme.h
+++ b/pidgin/gtkicon-theme.h
@@ -69,8 +69,7 @@ G_BEGIN_DECLS
 /**
  * pidgin_icon_theme_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for an icon theme.
  */
 GType pidgin_icon_theme_get_type(void);
 
diff --git a/pidgin/gtkstatus-icon-theme.h b/pidgin/gtkstatus-icon-theme.h
index 5f9cbdfac3..2af2b51a36 100644
--- a/pidgin/gtkstatus-icon-theme.h
+++ b/pidgin/gtkstatus-icon-theme.h
@@ -68,8 +68,7 @@ G_BEGIN_DECLS
 /**
  * pidgin_status_icon_theme_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for a status icon theme.
  */
 GType pidgin_status_icon_theme_get_type(void);
 
diff --git a/pidgin/pidginstock.h b/pidgin/pidginstock.h
index a4a8596a32..d8983d8395 100644
--- a/pidgin/pidginstock.h
+++ b/pidgin/pidginstock.h
@@ -222,8 +222,7 @@ G_BEGIN_DECLS
 /**
  * pidgin_stock_icon_theme_get_type:
  *
- * GObject foo.
- * @internal.
+ * Returns: The #GType for a stock icon theme.
  */
 GType pidgin_stock_icon_theme_get_type(void);