Give dissector_all_heur_tables_foreach_table() a sort function.

This makes it a bit more like dissector_all_tables_foreach_table.

Improve comments and clean up whitespace while we're at it.

Change-Id: I5147427f864add285e3bb6cb35ad9fa83bea516c
Reviewed-on: https://code.wireshark.org/review/5714
Reviewed-by: Guy Harris <guy@alum.mit.edu>

1 files changed, 12 insertions, 4 deletions

diff --git a/epan/packet.h b/epan/packet.h
index 66cce73667..2ac0b8b82b 100644
--- a/epan/packet.h
+++ b/epan/packet.h
@@ -183,12 +183,12 @@ WS_DLL_PUBLIC void dissector_table_foreach_handle(const char *table_name, DATFun
 
 /** Iterate over all dissector tables.
  *
- * Walk all dissector tables calling a user supplied function on each
+ * Walk the set of dissector tables calling a user supplied function on each
  * table.
  * @param[in] func The function to call for each table.
  * @param[in] user_data User data to pass to the function.
- * @param[in] compare_key_func Function used to sort tables before calling
- * the function.  No sorting is done if NULL. */
+ * @param[in] compare_key_func Function used to sort the set of tables before
+ * calling the function.  No sorting is done if NULL. */
 WS_DLL_PUBLIC void dissector_all_tables_foreach_table (DATFunc_table func,
     gpointer user_data, GCompareFunc compare_key_func);
 
@@ -359,8 +359,16 @@ WS_DLL_PUBLIC void register_heur_dissector_list(const char *name,
 typedef void (*DATFunc_heur_table) (const gchar *table_name,
     heur_dissector_list_t *table, gpointer user_data);
 
+/** Iterate over all heuristic dissector tables.
+ *
+ * Walk the set of heuristic dissector tables calling a user supplied function
+ * on each table.
+ * @param[in] func The function to call for each table.
+ * @param[in] user_data User data to pass to the function.
+ * @param[in] compare_key_func Function used to sort the set of tables before
+ * calling the function.  No sorting is done if NULL. */
 WS_DLL_PUBLIC void dissector_all_heur_tables_foreach_table (DATFunc_heur_table func,
-    gpointer user_data);
+    gpointer user_data, GCompareFunc compare_key_func);
 
 /* true if a heur_dissector list of that anme exists to be registered into */
 WS_DLL_PUBLIC gboolean has_heur_dissector_list(const gchar *name);