fix/add doxygen comments

svn path=/trunk/; revision=15941

5 files changed, 47 insertions, 7 deletions

diff --git a/gtk/capture_if_details_dlg.h b/gtk/capture_if_details_dlg.h
index 31d2bf2e2f..91b8072bd6 100644
--- a/gtk/capture_if_details_dlg.h
+++ b/gtk/capture_if_details_dlg.h
@@ -22,6 +22,14 @@
  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  */
 
+/** @file
+ *  Capture "Interface Details" dialog box
+ *  @ingroup dialog_group
+ */
 
+/** Open the dialog box.
+ *
+ * @param iface the interface name to show
+ */
 extern void capture_if_details_open(char *iface);
 
diff --git a/gtk/cfilter_combo_utils.h b/gtk/cfilter_combo_utils.h
index 09ff0368af..580c766436 100644
--- a/gtk/cfilter_combo_utils.h
+++ b/gtk/cfilter_combo_utils.h
@@ -22,6 +22,10 @@
  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  */
 
+/** @file
+ *  Capture filter combo box routines
+ */
+
 extern void cfilter_combo_recent_write_all(FILE *rf);
 extern gboolean cfilter_combo_add_recent(gchar *s);
 
diff --git a/gtk/fileset_dlg.h b/gtk/fileset_dlg.h
index b0330065d6..9ed4b3a7bf 100644
--- a/gtk/fileset_dlg.h
+++ b/gtk/fileset_dlg.h
@@ -25,12 +25,30 @@
 #ifndef __FILESET_DLG_H__
 #define __FILESET_DLG_H__
 
+/** @file
+ *  "File Set" dialog box.
+ *  @ingroup dialog_group
+ */
 
-/* start getting stats from all files */
+/** Open the fileset dialog.
+ *
+ * @param w calling widget (unused)
+ * @param d data from calling widget (unused)
+ */
 extern void fileset_cb(GtkWidget *w, gpointer d);
 
+/** Open the next file in the file set, or do nothing if already the last file.
+ *
+ * @param w calling widget (unused)
+ * @param d data from calling widget (unused)
+ */
 extern void fileset_next_cb(GtkWidget *w, gpointer d);
 
+/** Open the previous file in the file set, or do nothing if already the first file.
+ *
+ * @param w calling widget (unused)
+ * @param d data from calling widget (unused)
+ */
 extern void fileset_previous_cb(GtkWidget *w, gpointer d);
 
 #endif /* fileset_dlg.h */
diff --git a/gtk/main.h b/gtk/main.h
index 68e9c8d599..eae8a1dd34 100644
--- a/gtk/main.h
+++ b/gtk/main.h
@@ -51,16 +51,20 @@
   @enddot
  */
 
-extern GString *comp_info_str, *runtime_info_str;
-
 /** @file
  *  The main window, filter toolbar, program start/stop and a lot of other things
  *  @ingroup main_window_group
  *  @ingroup windows_group
  */
 
-/** Global capture options. */
+/** Global compile time version string */
+extern GString *comp_info_str;
+/** Global runtime version string */
+extern GString *runtime_info_str;
+
+/** Global capture options type. */
 typedef struct capture_options_tag * p_capture_options_t;
+/** Pointer to global capture options. */
 extern p_capture_options_t capture_opts;
 
 extern void protect_thread_critical_region(void);
@@ -281,7 +285,7 @@ extern gboolean main_filter_packets(capture_file *cf, const gchar *dftext,
 extern void dnd_init(GtkWidget *w);
 
 /** Open a new file coming from drag and drop.
- * @param selection_data the selection data reported from GTK
+ * @param cf_names_freeme the selection data reported from GTK
  */
 extern void dnd_open_file_cmd(gchar *cf_names_freeme);
 
diff --git a/gtk/range_utils.h b/gtk/range_utils.h
index fded166d46..2da6fd272b 100644
--- a/gtk/range_utils.h
+++ b/gtk/range_utils.h
@@ -39,14 +39,20 @@
  */
 extern gboolean range_check_validity(packet_range_t *range);
 
+#if GTK_MAJOR_VERSION < 2
 /** Create a new range widget.
  *
  * @param range the range to set
-#if GTK_MAJOR_VERSION < 2
  * @param accel_group accelerator group (GTK1 only)
-#endif
  * @return the new range widget
  */
+#else
+/** Create a new range widget.
+ *
+ * @param range the range to set
+ * @return the new range widget
+ */
+#endif
 extern GtkWidget *range_new(packet_range_t *range
 #if GTK_MAJOR_VERSION < 2
 , GtkAccelGroup *accel_group