From 5800789df23dd5fd42c1abc161f4d53d290352e5 Mon Sep 17 00:00:00 2001
From: Vincent Sanders <vince@netsurf-browser.org>
Date: Mon, 8 Oct 2012 14:51:48 +0100
Subject: trivial docuemntation cleanups to address some of the huge number of
 docuemntation warnings

---
 gtk/sexy_icon_entry.c | 22 +++++++++++-----------
 gtk/toolbar.c         |  2 +-
 2 files changed, 12 insertions(+), 12 deletions(-)

(limited to 'gtk')

diff --git a/gtk/sexy_icon_entry.c b/gtk/sexy_icon_entry.c
index b71e92ebe..172b92117 100644
--- a/gtk/sexy_icon_entry.c
+++ b/gtk/sexy_icon_entry.c
@@ -808,9 +808,9 @@ sexy_icon_entry_new(void)
 
 /**
  * sexy_icon_entry_set_icon
- * @entry: A #SexyIconEntry.
- * @position: Icon position.
- * @icon: A #GtkImage to set as the icon.
+ * @param entry A #SexyIconEntry.
+ * @param position Icon position.
+ * @param icon A #GtkImage to set as the icon.
  *
  * Sets the icon shown in the entry
  */
@@ -869,9 +869,9 @@ sexy_icon_entry_set_icon(SexyIconEntry *entry, SexyIconEntryPosition icon_pos,
 
 /**
  * sexy_icon_entry_set_icon_highlight
- * @entry: A #SexyIconEntry;
- * @position: Icon position.
- * @highlight: TRUE if the icon should highlight on mouse-over
+ * @param entry A #SexyIconEntry;
+ * @param position Icon position.
+ * @param highlight TRUE if the icon should highlight on mouse-over
  *
  * Determines whether the icon will highlight on mouse-over.
  */
@@ -896,8 +896,8 @@ sexy_icon_entry_set_icon_highlight(SexyIconEntry *entry,
 
 /**
  * sexy_icon_entry_get_icon
- * @entry: A #SexyIconEntry.
- * @position: Icon position.
+ * @param entry A #SexyIconEntry.
+ * @param position Icon position.
  *
  * Retrieves the image used for the icon
  *
@@ -916,8 +916,8 @@ sexy_icon_entry_get_icon(const SexyIconEntry *entry,
 
 /**
  * sexy_icon_entry_get_icon_highlight
- * @entry: A #SexyIconEntry.
- * @position: Icon position.
+ * @param entry A #SexyIconEntry.
+ * @param position Icon position.
  *
  * Retrieves whether entry will highlight the icon on mouseover.
  *
@@ -947,7 +947,7 @@ clear_button_clicked_cb(SexyIconEntry *icon_entry,
 
 /**
  * sexy_icon_entry_add_clear_button
- * @icon_entry: A #SexyIconEntry.
+ * @param icon_entry A #SexyIconEntry.
  *
  * A convenience function to add a clear button to the end of the entry.
  * This is useful for search boxes.
diff --git a/gtk/toolbar.c b/gtk/toolbar.c
index 9c89ee0c9..7cc20aa9f 100644
--- a/gtk/toolbar.c
+++ b/gtk/toolbar.c
@@ -1033,7 +1033,7 @@ void nsgtk_toolbar_temp_connect(nsgtk_scaffolding *g, nsgtk_toolbar_button i)
 
 /**
  * load toolbar settings from file; file is a set of fields arranged as
- * <itemreference>;<itemlocation>|<itemreference>;<itemlocation>| etc
+ * [itemreference];[itemlocation]|[itemreference];[itemlocation]| etc
  */
 void nsgtk_toolbar_customization_load(nsgtk_scaffolding *g)
 {
-- 
cgit v1.2.3