fix various doxygen warnings

svn path=/trunk/; revision=14958

gtk/compat_macros.h

@@ -255,7 +255,6 @@ dlg_radio_button_new_with_label_with_mnemonic( \
  *
  * @param radio_group group the radio buttons (another radio button or NULL for first one)
  * @param label_text the text to display
- * @param accel_group accelerator group (GTK1 only)
  * @return the new radio button
  */
 #define RADIO_BUTTON_NEW_WITH_LABEL(radio_group, label_text) \

gtk/help_dlg.h

@@ -86,11 +86,11 @@ void topic_cb(GtkWidget *widget, topic_action_e topic);
  * @param data user_data (unused)
  * @param topic the topic to display
  */
-void topic_menu_cb(GtkWidget *w _U_, gpointer data _U_, topic_action_e topic);
+void topic_menu_cb(GtkWidget *widget _U_, gpointer data _U_, topic_action_e topic);
 
 /** Check, if a specific topic is available.
  *
- * @param topic the topic to display
+ * @param action the topic action to display
  * @return TRUE, if topic is available, FALSE if not
  */
 gboolean topic_available(topic_action_e action);

gtk/main.h

@@ -271,7 +271,7 @@ extern gboolean main_filter_packets(capture_file *cf, const gchar *dftext,
 
 /** Init the drag-n-drop functionality.
  *
- * @param the target widget for this dnd operations
+ * @param w the target widget for this dnd operations
  */
 extern void dnd_init(GtkWidget *w);
 

gtk/menu.h

@@ -91,8 +91,9 @@ extern void set_menus_for_packet_history(gboolean back_history, gboolean forward
 
 /** The current file has changed, we need to update the file set menu items.
  *
- * @param back_history some back history entries available
- * @param forward_history some forward history entries available
+ * @param file_set the current file is part of a file set
+ * @param previous_file the previous file set (or NULL)
+ * @param next_file the next file set (or NULL)
  */
 extern void set_menus_for_file_set(gboolean file_set, gboolean previous_file, gboolean next_file);
 

gtk/recent.h

@@ -102,7 +102,7 @@ extern void write_recent_geom(gpointer key, gpointer value, gpointer rf);
  * question.  Return an indication of whether it succeeded or failed
  * in some fashion.
  *
- * @param a string of the form "<recent name>:<recent value>", as might appear
+ * @param prefarg a string of the form "<recent name>:<recent value>", as might appear
  * as an argument to a "-o" command line option
  * @return PREFS_SET_OK or PREFS_SET_SYNTAX_ERR
  */