fix doxygen generation

[obnox/wireshark/wip.git] / menu.h

diff --git a/menu.h b/menu.h
index c8726fe7adfa230a29a29f1d0f32bb9bea2ae5c1..dc951782109d0ab8b5a599628156bbe6b2c76690 100644 (file)
--- a/menu.h
+++ b/menu.h
@@ -1,23 +1,23 @@
 /* menu.h
- * Menu definitions
+ * Definitions for menu routines with toolkit-independent APIs but
+ * toolkit-dependent implementations.
  *
- * $Id: menu.h,v 1.4 1998/12/17 05:42:27 gram Exp $
+ * $Id$
  *
  * Ethereal - Network traffic analyzer
- * By Gerald Combs <gerald@zing.org>
+ * By Gerald Combs <gerald@ethereal.com>
  * Copyright 1998 Gerald Combs
  *
- * 
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License
  * as published by the Free Software Foundation; either version 2
  * of the License, or (at your option) any later version.
- * 
+ *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
- * 
+ *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
@@ -31,20 +31,38 @@ extern "C" {
 #endif /* __cplusplus */
 
 
-void menus_init(void);
+/* Add a new recent capture filename to the "Recent Files" submenu
+   (duplicates will be ignored) */
+void add_menu_recent_capture_file(gchar *file);
+
+/* Routines to enable or disable sets of menu items. */
+
+/* Enable or disable menu items based on whether you have a capture file
+   you've finished reading. */
+void set_menus_for_capture_file(gboolean);
 
-#ifdef GTK_HAVE_FEATURES_1_1_0
-void get_main_menu (GtkWidget **, GtkAccelGroup **);
-#else
-void get_main_menu (GtkWidget **, GtkAcceleratorTable **);
-#endif
-void set_menu_sensitivity (gchar *, gint);
-void set_menu_object_data (gchar *path, gchar *key, gpointer data);
-void menus_create (GtkMenuEntry *, int);
+/* Enable or disable menu items based on whether you have an unsaved
+   capture file you've finished reading. */
+void set_menus_for_unsaved_capture_file(gboolean);
 
+/* Enable or disable menu items based on whether there's a capture in
+   progress. */
+void set_menus_for_capture_in_progress(gboolean);
+
+/* Enable or disable menu items based on whether you have some captured
+   packets. */
+void set_menus_for_captured_packets(gboolean);
+
+/* Enable or disable menu items based on whether a packet is selected. */
+void set_menus_for_selected_packet(capture_file *cf);
+
+/* Enable or disable menu items based on whether a tree row is selected
+   and and on whether a "Match Selected" can be done. */
+void set_menus_for_selected_tree_row(capture_file *cf);
 
 #ifdef __cplusplus
 }
 #endif /* __cplusplus */
 
 #endif /* __MENU_H__ */
+