Squelch some qualifier (const vs. non-const) warnings.
[obnox/wireshark/wip.git] / ui_util.h
index c97fcb8bdc3bb6c6596153441b35bc4f7be75cc3..217f675250c6549771191e592540d486efe274ad 100644 (file)
--- a/ui_util.h
+++ b/ui_util.h
@@ -1,10 +1,12 @@
 /* ui_util.h
- * Definitions for UI utility routines
+ * Declarations of UI utility routines; these routines have GUI-independent
+ * APIs, but GUI-dependent implementations, so that they can be called by
+ * GUI-independent code to affect the GUI.
  *
  * $Id$
  *
- * Ethereal - Network traffic analyzer
- * By Gerald Combs <gerald@ethereal.com>
+ * Wireshark - Network traffic analyzer
+ * By Gerald Combs <gerald@wireshark.org>
  * Copyright 1998 Gerald Combs
  *
  * This program is free software; you can redistribute it and/or
 extern "C" {
 #endif /* __cplusplus */
 
-/* Set the name of the top-level window and its icon. */
-void set_main_window_name(gchar *);
+/* gui_utils.c */
 
+/* Set the name of the top-level window and its icon. */
+void set_main_window_name(const gchar *);
+/* Update the name of the main window if the user-specified decoration
+   changed. */
+void update_main_window_name(void);
 /* update the main window */
 extern void main_window_update(void);
 /* exit the main window */
@@ -41,10 +47,13 @@ extern void main_window_nested_quit(void);
 /* quit the main window */
 extern void main_window_quit(void);
 
-/* read from a pipe */
+/* read from a pipe (callback) */
 typedef gboolean (*pipe_input_cb_t) (gint source, gpointer user_data);
+/* install callback function, called if pipe input is available */
 extern void pipe_input_set_handler(gint source, gpointer user_data, int *child_process, pipe_input_cb_t input_cb);
 
+/* packet_list.c */
+
 /* packet list related functions */
 void packet_list_clear(void);
 void packet_list_freeze(void);
@@ -59,23 +68,8 @@ void packet_list_set_cls_time_width(gint);
 gpointer packet_list_get_row_data(gint);
 void packet_list_set_selected_row(gint);
 gint packet_list_get_sort_column(void);
+void packet_list_set_sort_column(void);
 
-/* create byte views in the main window */
-void add_main_byte_views(epan_dissect_t *edt);
-/* display the protocol tree in the main window */
-void main_proto_tree_draw(proto_tree *protocol_tree);
-
-void clear_tree_and_hex_views(void);
-
-/* Destroy all popup packet windows. */
-void destroy_packet_wins(void);
-
-/* Destroy the save as dialog */
-void file_save_as_destroy(void);
-
-#define destroy_cfile_wins() \
-    destroy_packet_wins(); \
-    file_save_as_destroy();
 
 #ifdef __cplusplus
 }