aboutsummaryrefslogtreecommitdiffstats
path: root/epan
diff options
context:
space:
mode:
authorMoshe Kaplan <me@moshekaplan.com>2021-11-25 22:31:05 -0500
committerWireshark GitLab Utility <gerald+gitlab-utility@wireshark.org>2021-11-29 21:27:45 +0000
commit1c3a9af8697d9d0e442b72cd8a637187e3aa685c (patch)
tree81e4bcf7820806cbb6b261fc481b4a9f3286b849 /epan
parent9cfce57ac0f17e6838eec35d810e41e1581f6d35 (diff)
Add files with WS_DLL_PUBLIC to Doxygen
Add @file markers for most files that contain functions exported with WS_DLL_PUBLIC so that Doxygen will generate documentation for them.
Diffstat (limited to 'epan')
-rw-r--r--epan/addr_resolv.h2
-rw-r--r--epan/address.h2
-rw-r--r--epan/address_types.h2
-rw-r--r--epan/app_mem_usage.h3
-rw-r--r--epan/asn1.h3
-rw-r--r--epan/charsets.h2
-rw-r--r--epan/column-utils.h2
-rw-r--r--epan/column.h2
-rw-r--r--epan/conversation_debug.h2
-rw-r--r--epan/crc10-tvb.h2
-rw-r--r--epan/crc16-tvb.h2
-rw-r--r--epan/crc32-tvb.h2
-rw-r--r--epan/crc6-tvb.h2
-rw-r--r--epan/crypt/dot11decrypt_system.h2
-rw-r--r--epan/crypt/dot11decrypt_user.h2
-rw-r--r--epan/crypt/dot11decrypt_ws.h2
-rw-r--r--epan/diam_dict.h3
-rw-r--r--epan/disabled_protos.h2
-rw-r--r--epan/dtd_parse.h2
-rw-r--r--epan/dvb_chartbl.h2
-rw-r--r--epan/eap.h2
-rw-r--r--epan/epan.h2
-rw-r--r--epan/epan_dissect.h2
-rw-r--r--epan/etypes.h2
-rw-r--r--epan/ex-opt.h3
-rw-r--r--epan/expert.h2
-rw-r--r--epan/export_object.h2
-rw-r--r--epan/exported_pdu.h3
-rw-r--r--epan/follow.h2
-rw-r--r--epan/frame_data_sequence.h2
-rw-r--r--epan/ftypes/ftypes.h2
-rw-r--r--epan/funnel.h3
-rw-r--r--epan/golay.h2
-rw-r--r--epan/guid-utils.h2
-rw-r--r--epan/iana_charsets.h2
-rw-r--r--epan/in_cksum.h2
-rw-r--r--epan/ipproto.h2
-rw-r--r--epan/ipv4.h2
-rw-r--r--epan/ipv6.h2
-rw-r--r--epan/maxmind_db.h2
-rw-r--r--epan/media_params.h2
-rw-r--r--epan/next_tvb.h2
-rw-r--r--epan/packet.h2
-rw-r--r--epan/plugin_if.h2
-rw-r--r--epan/ppptypes.h2
-rw-r--r--epan/print.h2
-rw-r--r--epan/print_stream.h2
-rw-r--r--epan/protobuf_lang_tree.h2
-rw-r--r--epan/ptvcursor.h2
-rw-r--r--epan/reassemble.h2
-rw-r--r--epan/reedsolomon.h2
-rw-r--r--epan/register-int.h2
-rw-r--r--epan/req_resp_hdrs.h2
-rw-r--r--epan/rtd_table.h2
-rw-r--r--epan/rtp_pt.h2
-rw-r--r--epan/sctpppids.h2
-rw-r--r--epan/secrets.h2
-rw-r--r--epan/sequence_analysis.h2
-rw-r--r--epan/show_exception.h2
-rw-r--r--epan/srt_table.h2
-rw-r--r--epan/stat_tap_ui.h2
-rw-r--r--epan/stats_tree.h2
-rw-r--r--epan/stats_tree_priv.h2
-rw-r--r--epan/stream.h2
-rw-r--r--epan/tap.h2
-rw-r--r--epan/timestamp.h2
-rw-r--r--epan/timestats.h2
-rw-r--r--epan/to_str.h2
-rw-r--r--epan/tvbparse.h2
-rw-r--r--epan/tvbuff-int.h2
-rw-r--r--epan/tvbuff.h2
-rw-r--r--epan/uat-int.h3
-rw-r--r--epan/uat.h3
-rw-r--r--epan/value_string.h2
-rw-r--r--epan/wmem_scopes.h2
-rw-r--r--epan/wscbor.h2
-rw-r--r--epan/wslua/init_wslua.h3
-rw-r--r--epan/wslua/wslua_file_common.h3
-rw-r--r--epan/wslua/wslua_pinfo_common.h3
79 files changed, 80 insertions, 89 deletions
diff --git a/epan/addr_resolv.h b/epan/addr_resolv.h
index 313e8f9bcf..56377b0992 100644
--- a/epan/addr_resolv.h
+++ b/epan/addr_resolv.h
@@ -1,4 +1,4 @@
-/* addr_resolv.h
+/** @file
* Definitions for network object lookup
*
* Laurent Deniel <laurent.deniel@free.fr>
diff --git a/epan/address.h b/epan/address.h
index 24f8470233..953f39cc0b 100644
--- a/epan/address.h
+++ b/epan/address.h
@@ -1,4 +1,4 @@
-/* address.h
+/** @file
* Definitions for structures storing addresses, and for the type of
* variables holding port-type values
*
diff --git a/epan/address_types.h b/epan/address_types.h
index 5f83588b47..b41298f9e8 100644
--- a/epan/address_types.h
+++ b/epan/address_types.h
@@ -1,4 +1,4 @@
-/* address_types.h
+/** @file
* Definitions for address types
*
* Wireshark - Network traffic analyzer
diff --git a/epan/app_mem_usage.h b/epan/app_mem_usage.h
index 44c01f1479..7e7b79e2c7 100644
--- a/epan/app_mem_usage.h
+++ b/epan/app_mem_usage.h
@@ -1,5 +1,4 @@
-/*
- * app_mem_usage.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/epan/asn1.h b/epan/asn1.h
index bbc4cd4748..861692b63b 100644
--- a/epan/asn1.h
+++ b/epan/asn1.h
@@ -1,4 +1,5 @@
-/* asn1.h
+/** @file
+ *
* Common data for ASN.1
* 2007 Anders Broman
*
diff --git a/epan/charsets.h b/epan/charsets.h
index d5099119d8..7502afd374 100644
--- a/epan/charsets.h
+++ b/epan/charsets.h
@@ -1,4 +1,4 @@
-/* charsets.h
+/** @file
* Routines for handling character sets
*
* Wireshark - Network traffic analyzer
diff --git a/epan/column-utils.h b/epan/column-utils.h
index 457dd1f4cb..6d39191422 100644
--- a/epan/column-utils.h
+++ b/epan/column-utils.h
@@ -1,4 +1,4 @@
-/* column-utils.h
+/** @file
* Definitions for column utility structures and routines
*
* Wireshark - Network traffic analyzer
diff --git a/epan/column.h b/epan/column.h
index 2a641e8dbb..5950a7869a 100644
--- a/epan/column.h
+++ b/epan/column.h
@@ -1,4 +1,4 @@
-/* column.h
+/** @file
* Definitions for column handling routines
*
* Wireshark - Network traffic analyzer
diff --git a/epan/conversation_debug.h b/epan/conversation_debug.h
index 924fbff5eb..bf6bb903a9 100644
--- a/epan/conversation_debug.h
+++ b/epan/conversation_debug.h
@@ -1,4 +1,4 @@
-/* conversation_debug.h
+/** @file
* A file of debug printing stuff for conversation-related things,
* although really anything can use this so long as it includes this
* header file and defines DEBUG_CONVERSATION in conversation.c
diff --git a/epan/crc10-tvb.h b/epan/crc10-tvb.h
index cd7b2382f3..bf7c047a71 100644
--- a/epan/crc10-tvb.h
+++ b/epan/crc10-tvb.h
@@ -1,4 +1,4 @@
-/* crc10-tvb.h
+/** @file
* Declaration of CRC-10 tvbuff routines
*
* Wireshark - Network traffic analyzer
diff --git a/epan/crc16-tvb.h b/epan/crc16-tvb.h
index 454cfbc992..2e85dd7915 100644
--- a/epan/crc16-tvb.h
+++ b/epan/crc16-tvb.h
@@ -1,4 +1,4 @@
-/* crc16-tvb.h
+/** @file
* Declaration of CRC-16 tvbuff routines
*
* 2004 Richard van der Hoff <richardv@mxtelecom.com>
diff --git a/epan/crc32-tvb.h b/epan/crc32-tvb.h
index 8e06e4ba5d..ea67370ce5 100644
--- a/epan/crc32-tvb.h
+++ b/epan/crc32-tvb.h
@@ -1,4 +1,4 @@
-/* crc32-tvb.h
+/** @file
* Declaration of CRC-32 tvbuff routines
*
* Wireshark - Network traffic analyzer
diff --git a/epan/crc6-tvb.h b/epan/crc6-tvb.h
index 1c105568d0..6c2c932fe9 100644
--- a/epan/crc6-tvb.h
+++ b/epan/crc6-tvb.h
@@ -1,4 +1,4 @@
-/* crc6-tvb.h
+/** @file
* Declaration of CRC-6 tvbuff routines
*
* Wireshark - Network traffic analyzer
diff --git a/epan/crypt/dot11decrypt_system.h b/epan/crypt/dot11decrypt_system.h
index 32a0db8f6d..465639aa79 100644
--- a/epan/crypt/dot11decrypt_system.h
+++ b/epan/crypt/dot11decrypt_system.h
@@ -1,4 +1,4 @@
-/* dot11decrypt_system.h
+/** @file
*
* Copyright (c) 2006 CACE Technologies, Davis (California)
* All rights reserved.
diff --git a/epan/crypt/dot11decrypt_user.h b/epan/crypt/dot11decrypt_user.h
index 19cc5147f2..0cb359853c 100644
--- a/epan/crypt/dot11decrypt_user.h
+++ b/epan/crypt/dot11decrypt_user.h
@@ -1,4 +1,4 @@
-/* dot11decrypt_user.h
+/** @file
*
* Copyright (c) 2006 CACE Technologies, Davis (California)
* All rights reserved.
diff --git a/epan/crypt/dot11decrypt_ws.h b/epan/crypt/dot11decrypt_ws.h
index 026bc936e6..b22a5db181 100644
--- a/epan/crypt/dot11decrypt_ws.h
+++ b/epan/crypt/dot11decrypt_ws.h
@@ -1,4 +1,4 @@
-/* dot11decrypt_ws.h
+/** @file
*
* Copyright (c) 2006 CACE Technologies, Davis (California)
* All rights reserved.
diff --git a/epan/diam_dict.h b/epan/diam_dict.h
index a67bb0137d..e2111a5e55 100644
--- a/epan/diam_dict.h
+++ b/epan/diam_dict.h
@@ -1,5 +1,4 @@
-/*
- ** diam_dict.h
+/** @file
** Diameter Dictionary Import Routines
**
** (c) 2007, Luis E. Garcia Ontanon <luis@ontanon.org>
diff --git a/epan/disabled_protos.h b/epan/disabled_protos.h
index d184ba3142..bea57367bd 100644
--- a/epan/disabled_protos.h
+++ b/epan/disabled_protos.h
@@ -1,4 +1,4 @@
-/* disabled_protos.h
+/** @file
* Declarations of routines for reading and writing protocols file that determine
* enabling and disabling of protocols.
*
diff --git a/epan/dtd_parse.h b/epan/dtd_parse.h
index c603cba704..56a7d6448d 100644
--- a/epan/dtd_parse.h
+++ b/epan/dtd_parse.h
@@ -1,4 +1,4 @@
-/* dtd_parse.h
+/** @file
* an XML dissector for Wireshark
* header file to declare functions defined in lexer and used in parser,
* or vice versa
diff --git a/epan/dvb_chartbl.h b/epan/dvb_chartbl.h
index affe18dcfc..18e0d48d09 100644
--- a/epan/dvb_chartbl.h
+++ b/epan/dvb_chartbl.h
@@ -1,4 +1,4 @@
-/* dvb_chartbl.h
+/** @file
* Routines for handling DVB-SI character tables (as defined in EN 300 468)
*
* Wireshark - Network traffic analyzer
diff --git a/epan/eap.h b/epan/eap.h
index 3810583132..1bdd5d6b73 100644
--- a/epan/eap.h
+++ b/epan/eap.h
@@ -1,4 +1,4 @@
-/* eap.h
+/** @file
* Extenal definitions for EAP Extensible Authentication Protocol dissection
* RFC 2284, RFC 3748
*
diff --git a/epan/epan.h b/epan/epan.h
index 0f19894aa9..7dea46d9c7 100644
--- a/epan/epan.h
+++ b/epan/epan.h
@@ -1,4 +1,4 @@
-/* epan.h
+/** @file
*
* Wireshark Protocol Analyzer Library
*
diff --git a/epan/epan_dissect.h b/epan/epan_dissect.h
index 5995e2274d..e16757f492 100644
--- a/epan/epan_dissect.h
+++ b/epan/epan_dissect.h
@@ -1,4 +1,4 @@
-/* epan_dissect.h
+/** @file
*
* Wireshark Protocol Analyzer Library
*
diff --git a/epan/etypes.h b/epan/etypes.h
index dfeed39837..62260070d2 100644
--- a/epan/etypes.h
+++ b/epan/etypes.h
@@ -1,4 +1,4 @@
-/* etypes.h
+/** @file
* Defines ethernet packet types, similar to tcpdump's ethertype.h
*
* Wireshark - Network traffic analyzer
diff --git a/epan/ex-opt.h b/epan/ex-opt.h
index b4d7e06654..5ce64a89a0 100644
--- a/epan/ex-opt.h
+++ b/epan/ex-opt.h
@@ -1,5 +1,4 @@
-/*
- * ex-opt.h
+/** @file
*
* eXtension command line options
*
diff --git a/epan/expert.h b/epan/expert.h
index 019606ab7f..e152b89f5f 100644
--- a/epan/expert.h
+++ b/epan/expert.h
@@ -1,4 +1,4 @@
-/* expert.h
+/** @file
* Collecting of Expert information.
*
* For further info, see:
diff --git a/epan/export_object.h b/epan/export_object.h
index 23757e50d4..85dfedd3d9 100644
--- a/epan/export_object.h
+++ b/epan/export_object.h
@@ -1,4 +1,4 @@
-/* export_object.h
+/** @file
* GUI independent helper routines common to all export object taps.
*
* Wireshark - Network traffic analyzer
diff --git a/epan/exported_pdu.h b/epan/exported_pdu.h
index 9c89333286..7c7feaa139 100644
--- a/epan/exported_pdu.h
+++ b/epan/exported_pdu.h
@@ -1,5 +1,4 @@
-/*
- * exported_pdu.h
+/** @file
* Routines for exported_pdu dissection
* Copyright 2013, Anders Broman <anders-broman@ericsson.com>
*
diff --git a/epan/follow.h b/epan/follow.h
index 94111465a0..6a5f8718dd 100644
--- a/epan/follow.h
+++ b/epan/follow.h
@@ -1,4 +1,4 @@
-/* follow.h
+/** @file
*
* Copyright 1998 Mike Hall <mlh@io.com>
*
diff --git a/epan/frame_data_sequence.h b/epan/frame_data_sequence.h
index d474ef1474..035609307d 100644
--- a/epan/frame_data_sequence.h
+++ b/epan/frame_data_sequence.h
@@ -1,4 +1,4 @@
-/* frame_data_sequence.h
+/** @file
* Implements a sequence of frame_data structures
*
* Wireshark - Network traffic analyzer
diff --git a/epan/ftypes/ftypes.h b/epan/ftypes/ftypes.h
index 91c35deaeb..268c5f8405 100644
--- a/epan/ftypes/ftypes.h
+++ b/epan/ftypes/ftypes.h
@@ -1,4 +1,4 @@
-/* ftypes.h
+/** @file
* Definitions for field types
*
* Wireshark - Network traffic analyzer
diff --git a/epan/funnel.h b/epan/funnel.h
index 601755809a..02096d5159 100644
--- a/epan/funnel.h
+++ b/epan/funnel.h
@@ -1,5 +1,4 @@
-/*
- * funnel.h
+/** @file
*
* EPAN's GUI mini-API
*
diff --git a/epan/golay.h b/epan/golay.h
index 64c0a7c990..9711f068ef 100644
--- a/epan/golay.h
+++ b/epan/golay.h
@@ -1,4 +1,4 @@
-/*
+/** @file
* Provides routines for encoding and decoding the extended Golay
* (24,12,8) code.
*
diff --git a/epan/guid-utils.h b/epan/guid-utils.h
index 5bccb4785f..60cb7365d4 100644
--- a/epan/guid-utils.h
+++ b/epan/guid-utils.h
@@ -1,4 +1,4 @@
-/* guid-utils.h
+/** @file
* Definitions for GUID handling
*
* Wireshark - Network traffic analyzer
diff --git a/epan/iana_charsets.h b/epan/iana_charsets.h
index 588bbcef67..1cd2228db3 100644
--- a/epan/iana_charsets.h
+++ b/epan/iana_charsets.h
@@ -1,4 +1,4 @@
-/* iana_charsets.h
+/** @file
*
* Declarations for IANA-registered character sets
*
diff --git a/epan/in_cksum.h b/epan/in_cksum.h
index d28810a032..671546f6df 100644
--- a/epan/in_cksum.h
+++ b/epan/in_cksum.h
@@ -1,4 +1,4 @@
-/* in_cksum.h
+/** @file
* Declaration of Internet checksum routine.
*
* Copyright (c) 1988, 1992, 1993
diff --git a/epan/ipproto.h b/epan/ipproto.h
index 8640d7661c..5cb0c5204f 100644
--- a/epan/ipproto.h
+++ b/epan/ipproto.h
@@ -1,4 +1,4 @@
-/* ipproto.h
+/** @file
* Declarations of IP protocol numbers, and of routines for converting
* IP protocol numbers into strings.
*
diff --git a/epan/ipv4.h b/epan/ipv4.h
index 6c4702b826..6d93e49334 100644
--- a/epan/ipv4.h
+++ b/epan/ipv4.h
@@ -1,4 +1,4 @@
-/* ipv4.h
+/** @file
* Definitions of IPv4 address-and-mask structure, which is what an
* FT_IPV4 value is (even if there's no mask in a packet, those
* values can be compared against an address+mask in a filter
diff --git a/epan/ipv6.h b/epan/ipv6.h
index 1f096d9e88..b45f8528ab 100644
--- a/epan/ipv6.h
+++ b/epan/ipv6.h
@@ -1,4 +1,4 @@
-/* ipv6.h
+/** @file
* Definitions of IPv6 address-and-prefix structure, which is what an
* FT_IPV6 value is (even if there's no prefix in a packet, those
* values can be compared against an address+prefix in a filter
diff --git a/epan/maxmind_db.h b/epan/maxmind_db.h
index 94e492d109..51c08cad8a 100644
--- a/epan/maxmind_db.h
+++ b/epan/maxmind_db.h
@@ -1,4 +1,4 @@
-/* maxmind_db.h
+/** @file
* Maxmind database support
*
* Copyright 2018, Gerald Combs <gerald@wireshark.org>
diff --git a/epan/media_params.h b/epan/media_params.h
index b4747fc573..c06812236c 100644
--- a/epan/media_params.h
+++ b/epan/media_params.h
@@ -1,4 +1,4 @@
-/* media_params.h
+/** @file
* Routines for parsing media type parameters as per RFC 822 and RFC 2045
* Copyright 2004, Anders Broman.
* Copyright 2004, Olivier Biot.
diff --git a/epan/next_tvb.h b/epan/next_tvb.h
index fe66e3fed7..fe4cd25af0 100644
--- a/epan/next_tvb.h
+++ b/epan/next_tvb.h
@@ -1,4 +1,4 @@
-/* next_tvb.h
+/** @file
* Definitions for "next tvb" list
*
* Wireshark - Network traffic analyzer
diff --git a/epan/packet.h b/epan/packet.h
index 0cf6d772ed..57d0de8c32 100644
--- a/epan/packet.h
+++ b/epan/packet.h
@@ -1,4 +1,4 @@
-/* packet.h
+/** @file
* Definitions for packet disassembly structures and routines
*
* Wireshark - Network traffic analyzer
diff --git a/epan/plugin_if.h b/epan/plugin_if.h
index 7791c66d15..aee1895536 100644
--- a/epan/plugin_if.h
+++ b/epan/plugin_if.h
@@ -1,4 +1,4 @@
-/* plugin_if.h
+/** @file
* An API for Wireshark plugins
*
* This enables wireshark dissectors, especially those implemented by plugins
diff --git a/epan/ppptypes.h b/epan/ppptypes.h
index f713a2723f..09ed204d5e 100644
--- a/epan/ppptypes.h
+++ b/epan/ppptypes.h
@@ -1,4 +1,4 @@
-/* ppptypes.h
+/** @file
* Defines PPP packet types.
*
* Wireshark - Network traffic analyzer
diff --git a/epan/print.h b/epan/print.h
index 52da0ce2db..6c1a05b2bf 100644
--- a/epan/print.h
+++ b/epan/print.h
@@ -1,4 +1,4 @@
-/* print.h
+/** @file
* Definitions for printing packet analysis trees.
*
* Gilbert Ramirez <gram@alumni.rice.edu>
diff --git a/epan/print_stream.h b/epan/print_stream.h
index 25aa1d3e86..d41d4f10ba 100644
--- a/epan/print_stream.h
+++ b/epan/print_stream.h
@@ -1,4 +1,4 @@
-/* print_stream.h
+/** @file
* Definitions for print streams.
*
* Gilbert Ramirez <gram@alumni.rice.edu>
diff --git a/epan/protobuf_lang_tree.h b/epan/protobuf_lang_tree.h
index b05b4bd45f..fd952d6f91 100644
--- a/epan/protobuf_lang_tree.h
+++ b/epan/protobuf_lang_tree.h
@@ -1,4 +1,4 @@
-/* protobuf_lang_tree.h
+/** @file
*
* Routines of building and reading Protocol Buffers Language grammar tree.
* Copyright 2019, Huang Qiangxiong <qiangxiong.huang@qq.com>
diff --git a/epan/ptvcursor.h b/epan/ptvcursor.h
index ab4fcb6c06..1e6b35f86a 100644
--- a/epan/ptvcursor.h
+++ b/epan/ptvcursor.h
@@ -1,4 +1,4 @@
-/* ptvcursor.h
+/** @file
*
* Proto Tree TVBuff cursor
* Gilbert Ramirez <gram@alumni.rice.edu>
diff --git a/epan/reassemble.h b/epan/reassemble.h
index f3a1287795..9d85443cef 100644
--- a/epan/reassemble.h
+++ b/epan/reassemble.h
@@ -1,4 +1,4 @@
-/* reassemble.h
+/** @file
* Declarations of routines for {fragment,segment} reassembly
*
* Wireshark - Network traffic analyzer
diff --git a/epan/reedsolomon.h b/epan/reedsolomon.h
index f389628de0..9f584efe0a 100644
--- a/epan/reedsolomon.h
+++ b/epan/reedsolomon.h
@@ -1,4 +1,4 @@
-/* reedsolomon.h
+/** @file
*
* Global definitions for Reed-Solomon encoder/decoder,
* by Phil Karn (karn@ka9q.ampr.org) September 1996
diff --git a/epan/register-int.h b/epan/register-int.h
index aa5d3d8a21..8cb8f608b1 100644
--- a/epan/register-int.h
+++ b/epan/register-int.h
@@ -1,4 +1,4 @@
-/* register-int.h
+/** @file
* Definitions for protocol registration
*
* Wireshark - Network traffic analyzer
diff --git a/epan/req_resp_hdrs.h b/epan/req_resp_hdrs.h
index f29e970c11..247a9b037f 100644
--- a/epan/req_resp_hdrs.h
+++ b/epan/req_resp_hdrs.h
@@ -1,4 +1,4 @@
-/* req_resp_hdrs.h
+/** @file
* Declarations of routines handling protocols with a request/response line,
* headers, a blank line, and an optional body.
*
diff --git a/epan/rtd_table.h b/epan/rtd_table.h
index 2cda22bd12..a4679a09d3 100644
--- a/epan/rtd_table.h
+++ b/epan/rtd_table.h
@@ -1,4 +1,4 @@
-/* rtd_table.h
+/** @file
* GUI independent helper routines common to all Response Time Delay (RTD) taps.
* Based on srt_table.h
*
diff --git a/epan/rtp_pt.h b/epan/rtp_pt.h
index c58405f03d..a687a0978c 100644
--- a/epan/rtp_pt.h
+++ b/epan/rtp_pt.h
@@ -1,4 +1,4 @@
-/* rtp_pt.h
+/** @file
* Defines RTP payload types
*
* Wireshark - Network traffic analyzer
diff --git a/epan/sctpppids.h b/epan/sctpppids.h
index 0ea850cc48..005e5c2452 100644
--- a/epan/sctpppids.h
+++ b/epan/sctpppids.h
@@ -1,4 +1,4 @@
-/* sctpppids.h
+/** @file
* Declarations of SCTP payload protocol IDs.
*
* Copyright 2011-2021 by Thomas Dreibholz <dreibh [AT] iem.uni-due.de>
diff --git a/epan/secrets.h b/epan/secrets.h
index facff22994..a2c19756c2 100644
--- a/epan/secrets.h
+++ b/epan/secrets.h
@@ -1,4 +1,4 @@
-/* secrets.h
+/** @file
* Secrets management and processing.
* Copyright 2018, Peter Wu <peter@lekensteyn.nl>
*
diff --git a/epan/sequence_analysis.h b/epan/sequence_analysis.h
index 638be5cb2c..956d9a7afa 100644
--- a/epan/sequence_analysis.h
+++ b/epan/sequence_analysis.h
@@ -1,4 +1,4 @@
-/* sequence-analysis.h
+/** @file
* Flow sequence analysis
*
* Copied from gtk/graph_analysis.h
diff --git a/epan/show_exception.h b/epan/show_exception.h
index 5a6a1ec055..77146e7ccd 100644
--- a/epan/show_exception.h
+++ b/epan/show_exception.h
@@ -1,4 +1,4 @@
-/* show_exception.h
+/** @file
*
* Routines to put exception information into the protocol tree
*
diff --git a/epan/srt_table.h b/epan/srt_table.h
index 55d256c9d6..36697bd06b 100644
--- a/epan/srt_table.h
+++ b/epan/srt_table.h
@@ -1,4 +1,4 @@
-/* srt_table.h
+/** @file
* GUI independent helper routines common to all service response time (SRT) taps.
*
* Wireshark - Network traffic analyzer
diff --git a/epan/stat_tap_ui.h b/epan/stat_tap_ui.h
index 94f13a0a82..fc00d7de80 100644
--- a/epan/stat_tap_ui.h
+++ b/epan/stat_tap_ui.h
@@ -1,4 +1,4 @@
-/* stat_tap_ui.h
+/** @file
* Declarations of routines to register UI information for stats
*
* Wireshark - Network traffic analyzer
diff --git a/epan/stats_tree.h b/epan/stats_tree.h
index dee6179a7d..e890f3ba90 100644
--- a/epan/stats_tree.h
+++ b/epan/stats_tree.h
@@ -1,4 +1,4 @@
-/* stats_tree.h
+/** @file
* A counter tree API for Wireshark dissectors
* 2005, Luis E. G. Ontanon
*
diff --git a/epan/stats_tree_priv.h b/epan/stats_tree_priv.h
index 6de4099c87..43c9f2dc24 100644
--- a/epan/stats_tree_priv.h
+++ b/epan/stats_tree_priv.h
@@ -1,4 +1,4 @@
-/* stats_tree_priv.h
+/** @file
* implementor's API for stats_tree
* 2005, Luis E. G. Ontanon
*
diff --git a/epan/stream.h b/epan/stream.h
index 5e741c4bbf..1a7ad3e878 100644
--- a/epan/stream.h
+++ b/epan/stream.h
@@ -1,4 +1,4 @@
-/* stream.h
+/** @file
*
* Definititions for handling circuit-switched protocols
* which are handled as streams, and don't have lengths
diff --git a/epan/tap.h b/epan/tap.h
index 23f15f50dc..348f2e1974 100644
--- a/epan/tap.h
+++ b/epan/tap.h
@@ -1,4 +1,4 @@
-/* tap.h
+/** @file
* packet tap interface 2002 Ronnie Sahlberg
*
* Wireshark - Network traffic analyzer
diff --git a/epan/timestamp.h b/epan/timestamp.h
index b3ac3d70cc..13023ddeec 100644
--- a/epan/timestamp.h
+++ b/epan/timestamp.h
@@ -1,4 +1,4 @@
-/* timestamp.h
+/** @file
* Defines for packet timestamps
*
* Wireshark - Network traffic analyzer
diff --git a/epan/timestats.h b/epan/timestats.h
index 8adb20f6cf..f7ae406802 100644
--- a/epan/timestats.h
+++ b/epan/timestats.h
@@ -1,4 +1,4 @@
-/* timestats.h
+/** @file
* Routines and definitions for time statistics
* Copyright 2003 Lars Roland
*
diff --git a/epan/to_str.h b/epan/to_str.h
index 1be7c02450..a26907ec81 100644
--- a/epan/to_str.h
+++ b/epan/to_str.h
@@ -1,4 +1,4 @@
-/* to_str.h
+/** @file
* Definitions for utilities to convert various other types to strings.
*
* Wireshark - Network traffic analyzer
diff --git a/epan/tvbparse.h b/epan/tvbparse.h
index 8d56f9dea2..ecf76f3133 100644
--- a/epan/tvbparse.h
+++ b/epan/tvbparse.h
@@ -1,4 +1,4 @@
-/* tvbparse.h
+/** @file
*
* an API for text tvb parsers
*
diff --git a/epan/tvbuff-int.h b/epan/tvbuff-int.h
index 17128abdf7..49b65f2df9 100644
--- a/epan/tvbuff-int.h
+++ b/epan/tvbuff-int.h
@@ -1,4 +1,4 @@
-/* tvbuff-int.h
+/** @file
*
* Structures that most TVB users should not be accessing directly.
*
diff --git a/epan/tvbuff.h b/epan/tvbuff.h
index 934a65b941..2a56b9eb58 100644
--- a/epan/tvbuff.h
+++ b/epan/tvbuff.h
@@ -1,4 +1,4 @@
-/* tvbuff.h
+/** @file
*
* Testy, Virtual(-izable) Buffer of guint8*'s
*
diff --git a/epan/uat-int.h b/epan/uat-int.h
index 6b88e3d0fc..9f80ab8176 100644
--- a/epan/uat-int.h
+++ b/epan/uat-int.h
@@ -1,5 +1,4 @@
-/*
- * uat-int.h
+/** @file
*
* User Accessible Tables
* Maintain an array of user accessible data structures
diff --git a/epan/uat.h b/epan/uat.h
index 2936afc57e..b8a5cd62f0 100644
--- a/epan/uat.h
+++ b/epan/uat.h
@@ -1,5 +1,4 @@
-/*
- * uat.h
+/** @file
*
* User Accessible Tables
* Maintain an array of user accessible data structures
diff --git a/epan/value_string.h b/epan/value_string.h
index 940f5827db..8d9dbb9fcb 100644
--- a/epan/value_string.h
+++ b/epan/value_string.h
@@ -1,4 +1,4 @@
-/* value_string.h
+/** @file
* Definitions for value_string structures and routines
*
* Wireshark - Network traffic analyzer
diff --git a/epan/wmem_scopes.h b/epan/wmem_scopes.h
index 5980870b7f..92787b459a 100644
--- a/epan/wmem_scopes.h
+++ b/epan/wmem_scopes.h
@@ -1,4 +1,4 @@
-/* wmem_scopes.h
+/** @file
* Definitions for the Wireshark Memory Manager Scopes
* Copyright 2012, Evan Huus <eapache@gmail.com>
*
diff --git a/epan/wscbor.h b/epan/wscbor.h
index 43bad16905..eafba3a0c3 100644
--- a/epan/wscbor.h
+++ b/epan/wscbor.h
@@ -1,4 +1,4 @@
-/* wscbor.h
+/** @file
* Definitions for the Wireshark CBOR item decoding API.
* References:
* RFC 8949: https://tools.ietf.org/html/rfc8949
diff --git a/epan/wslua/init_wslua.h b/epan/wslua/init_wslua.h
index 0fdf0882b6..5063076d42 100644
--- a/epan/wslua/init_wslua.h
+++ b/epan/wslua/init_wslua.h
@@ -1,5 +1,4 @@
-/*
- * init_wslua.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/epan/wslua/wslua_file_common.h b/epan/wslua/wslua_file_common.h
index 936fc518d3..6ff98b65c7 100644
--- a/epan/wslua/wslua_file_common.h
+++ b/epan/wslua/wslua_file_common.h
@@ -1,5 +1,4 @@
-/*
- * wslua_file_common.h
+/** @file
*
* Wireshark's interface to the Lua Programming Language
* for file handling related source files.
diff --git a/epan/wslua/wslua_pinfo_common.h b/epan/wslua/wslua_pinfo_common.h
index 4d3392f512..3af3dfced1 100644
--- a/epan/wslua/wslua_pinfo_common.h
+++ b/epan/wslua/wslua_pinfo_common.h
@@ -1,5 +1,4 @@
-/*
- * wslua_pinfo_common.h
+/** @file
*
* Wireshark's interface to the Lua Programming Language
*