aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-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
-rw-r--r--include/ws_symbol_export.h2
-rw-r--r--wiretap/file_wrappers.h2
-rw-r--r--wiretap/merge.h2
-rw-r--r--wiretap/pcap-encap.h2
-rw-r--r--wiretap/pcapng_module.h2
-rw-r--r--wiretap/wtap-int.h2
-rw-r--r--wiretap/wtap.h2
-rw-r--r--wiretap/wtap_opttypes.h2
-rw-r--r--wsutil/adler32.h2
-rw-r--r--wsutil/base32.h2
-rw-r--r--wsutil/bitswap.h2
-rw-r--r--wsutil/buffer.h2
-rw-r--r--wsutil/cfutils.h2
-rw-r--r--wsutil/codecs.h2
-rw-r--r--wsutil/copyright_info.h2
-rw-r--r--wsutil/cpu_info.h2
-rw-r--r--wsutil/crash_info.h2
-rw-r--r--wsutil/crc10.h3
-rw-r--r--wsutil/crc11.h3
-rw-r--r--wsutil/crc16-plain.h3
-rw-r--r--wsutil/crc16.h2
-rw-r--r--wsutil/crc32.h2
-rw-r--r--wsutil/crc5.h2
-rw-r--r--wsutil/crc6.h3
-rw-r--r--wsutil/crc7.h3
-rw-r--r--wsutil/crc8.h2
-rw-r--r--wsutil/curve25519.h2
-rw-r--r--wsutil/eax.h2
-rw-r--r--wsutil/file_util.h2
-rw-r--r--wsutil/filesystem.h2
-rw-r--r--wsutil/g711.h3
-rw-r--r--wsutil/inet_addr.h2
-rw-r--r--wsutil/interface.h2
-rw-r--r--wsutil/json_dumper.h2
-rw-r--r--wsutil/mpeg-audio.h2
-rw-r--r--wsutil/os_version_info.h2
-rw-r--r--wsutil/please_report_bug.h2
-rw-r--r--wsutil/plugins.h2
-rw-r--r--wsutil/privileges.h2
-rw-r--r--wsutil/report_message.h2
-rw-r--r--wsutil/rsa.h2
-rw-r--r--wsutil/socket.h2
-rw-r--r--wsutil/str_util.h2
-rw-r--r--wsutil/strnatcmp.h2
-rw-r--r--wsutil/strptime.h2
-rw-r--r--wsutil/strtoi.h2
-rw-r--r--wsutil/time_util.h2
-rw-r--r--wsutil/type_util.h2
-rw-r--r--wsutil/wmem/wmem_array.h2
-rw-r--r--wsutil/wmem/wmem_core.h2
-rw-r--r--wsutil/wmem/wmem_interval_tree.h2
-rw-r--r--wsutil/wmem/wmem_list.h2
-rw-r--r--wsutil/wmem/wmem_map.h2
-rw-r--r--wsutil/wmem/wmem_miscutl.h2
-rw-r--r--wsutil/wmem/wmem_stack.h2
-rw-r--r--wsutil/wmem/wmem_strbuf.h2
-rw-r--r--wsutil/wmem/wmem_strutl.h2
-rw-r--r--wsutil/wmem/wmem_tree.h2
-rw-r--r--wsutil/wmem/wmem_user_cb.h2
-rw-r--r--wsutil/ws_assert.h2
-rw-r--r--wsutil/ws_getopt.h3
-rw-r--r--wsutil/ws_mempbrk.h2
-rw-r--r--wsutil/ws_pipe.h2
-rw-r--r--wsutil/wsgcrypt.h2
-rw-r--r--wsutil/wsjson.h3
-rw-r--r--wsutil/wslog.h3
-rw-r--r--wsutil/xtea.h3
146 files changed, 151 insertions, 162 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
*
diff --git a/include/ws_symbol_export.h b/include/ws_symbol_export.h
index 85b36d09f9..f4de27a404 100644
--- a/include/ws_symbol_export.h
+++ b/include/ws_symbol_export.h
@@ -1,4 +1,4 @@
-/*
+/** @file
* Cross platform defines for exporting symbols from shared libraries
*
* Wireshark - Network traffic analyzer
diff --git a/wiretap/file_wrappers.h b/wiretap/file_wrappers.h
index 14dfa94eef..4c644f321e 100644
--- a/wiretap/file_wrappers.h
+++ b/wiretap/file_wrappers.h
@@ -1,4 +1,4 @@
-/* file_wrappers.h
+/** @file
*
* Wiretap Library
* Copyright (c) 1998 by Gilbert Ramirez <gram@alumni.rice.edu>
diff --git a/wiretap/merge.h b/wiretap/merge.h
index bbc6e53ee7..4428825a26 100644
--- a/wiretap/merge.h
+++ b/wiretap/merge.h
@@ -1,4 +1,4 @@
-/* merge.h
+/** @file
* Definitions for routines for merging files.
*
* Wireshark - Network traffic analyzer
diff --git a/wiretap/pcap-encap.h b/wiretap/pcap-encap.h
index 5535e48a7d..53af9c3eff 100644
--- a/wiretap/pcap-encap.h
+++ b/wiretap/pcap-encap.h
@@ -1,4 +1,4 @@
-/* pcap-encap.h
+/** @file
* Declarations for routines to handle pcap/pcapng linktype values
*
* Wiretap Library
diff --git a/wiretap/pcapng_module.h b/wiretap/pcapng_module.h
index 656de39174..cea36e50cf 100644
--- a/wiretap/pcapng_module.h
+++ b/wiretap/pcapng_module.h
@@ -1,4 +1,4 @@
-/* pcap_module.h
+/** @file
*
* Wiretap Library
* Copyright (c) 1998 by Gilbert Ramirez <gram@alumni.rice.edu>
diff --git a/wiretap/wtap-int.h b/wiretap/wtap-int.h
index 62c6ffb578..1c8c7fd65d 100644
--- a/wiretap/wtap-int.h
+++ b/wiretap/wtap-int.h
@@ -1,4 +1,4 @@
-/* wtap-int.h
+/** @file
*
* Wiretap Library
* Copyright (c) 1998 by Gilbert Ramirez <gram@alumni.rice.edu>
diff --git a/wiretap/wtap.h b/wiretap/wtap.h
index 354f60e733..1b2bf702ca 100644
--- a/wiretap/wtap.h
+++ b/wiretap/wtap.h
@@ -1,4 +1,4 @@
-/* wtap.h
+/** @file
*
* Wiretap Library
* Copyright (c) 1998 by Gilbert Ramirez <gram@alumni.rice.edu>
diff --git a/wiretap/wtap_opttypes.h b/wiretap/wtap_opttypes.h
index 1d0bb7ab8f..c2e8749eab 100644
--- a/wiretap/wtap_opttypes.h
+++ b/wiretap/wtap_opttypes.h
@@ -1,4 +1,4 @@
-/* wtap_opttypes.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/wsutil/adler32.h b/wsutil/adler32.h
index e5b72b8110..2c56d8e83d 100644
--- a/wsutil/adler32.h
+++ b/wsutil/adler32.h
@@ -1,4 +1,4 @@
-/* adler32.h
+/** @file
* Compute the Adler32 checksum (RFC 1950)
* 2003 Tomas Kukosa
*
diff --git a/wsutil/base32.h b/wsutil/base32.h
index 75251e66b9..b1f1732bb8 100644
--- a/wsutil/base32.h
+++ b/wsutil/base32.h
@@ -1,4 +1,4 @@
-/* base32.h
+/** @file
* Base-32 conversion
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/bitswap.h b/wsutil/bitswap.h
index 8f4a05d9a0..26a2c64f88 100644
--- a/wsutil/bitswap.h
+++ b/wsutil/bitswap.h
@@ -1,4 +1,4 @@
-/* bitswap.h
+/** @file
* Macro to bitswap a byte by looking it up in a table
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/buffer.h b/wsutil/buffer.h
index 5ca90b1bd0..9f98f58418 100644
--- a/wsutil/buffer.h
+++ b/wsutil/buffer.h
@@ -1,4 +1,4 @@
-/* buffer.h
+/** @file
*
* Wiretap Library
* Copyright (c) 1998 by Gilbert Ramirez <gram@alumni.rice.edu>
diff --git a/wsutil/cfutils.h b/wsutil/cfutils.h
index c6ed5a2486..12cbefef4c 100644
--- a/wsutil/cfutils.h
+++ b/wsutil/cfutils.h
@@ -1,4 +1,4 @@
-/* cfutils.h
+/** @file
* Declarations of routines to work around deficiencies in Core Foundation,
* such as the lack of a routine to convert a CFString to a C string of
* arbitrary size.
diff --git a/wsutil/codecs.h b/wsutil/codecs.h
index 47f8ff1451..ea3ae88754 100644
--- a/wsutil/codecs.h
+++ b/wsutil/codecs.h
@@ -1,4 +1,4 @@
-/* codecs.h
+/** @file
* codecs interface 2007 Tomas Kukosa
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/copyright_info.h b/wsutil/copyright_info.h
index 83abcd6273..503355f5d5 100644
--- a/wsutil/copyright_info.h
+++ b/wsutil/copyright_info.h
@@ -1,4 +1,4 @@
-/* copyright_info.h
+/** @file
* Declarations of outines to report copyright information for stuff used
* by Wireshark
*
diff --git a/wsutil/cpu_info.h b/wsutil/cpu_info.h
index 145b1bef00..bd39974b9e 100644
--- a/wsutil/cpu_info.h
+++ b/wsutil/cpu_info.h
@@ -1,4 +1,4 @@
-/* cpu_info.h
+/** @file
* Declarations of routines to report CPU information
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/crash_info.h b/wsutil/crash_info.h
index ec50df345b..ce9e70f070 100644
--- a/wsutil/crash_info.h
+++ b/wsutil/crash_info.h
@@ -1,4 +1,4 @@
-/* crash_info.h
+/** @file
* Routines to try to provide more useful information in crash dumps.
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/crc10.h b/wsutil/crc10.h
index 2834cd3bbf..c1fb16014f 100644
--- a/wsutil/crc10.h
+++ b/wsutil/crc10.h
@@ -1,5 +1,4 @@
-/*
- * crc10.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/wsutil/crc11.h b/wsutil/crc11.h
index c9ac52ba18..52e018080c 100644
--- a/wsutil/crc11.h
+++ b/wsutil/crc11.h
@@ -1,5 +1,4 @@
-/*
- * crc11.h
+/** @file
* http://www.tty1.net/pycrc/faq_en.html#code-ownership
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/crc16-plain.h b/wsutil/crc16-plain.h
index f2efe1a0d3..3e95eaefc6 100644
--- a/wsutil/crc16-plain.h
+++ b/wsutil/crc16-plain.h
@@ -1,5 +1,4 @@
-/*
- * crc16-plain.h
+/** @file
* http://www.tty1.net/pycrc/faq_en.html#code-ownership
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/crc16.h b/wsutil/crc16.h
index 64b6203f13..0bd0de64fb 100644
--- a/wsutil/crc16.h
+++ b/wsutil/crc16.h
@@ -1,4 +1,4 @@
-/* crc16.h
+/** @file
* Declaration of CRC-16 routines and table
*
* 2004 Richard van der Hoff <richardv@mxtelecom.com>
diff --git a/wsutil/crc32.h b/wsutil/crc32.h
index 09f293277f..9f07045db5 100644
--- a/wsutil/crc32.h
+++ b/wsutil/crc32.h
@@ -1,4 +1,4 @@
-/* crc32.h
+/** @file
* Declaration of CRC-32 routine and table
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/crc5.h b/wsutil/crc5.h
index da3fde41fd..1201112048 100644
--- a/wsutil/crc5.h
+++ b/wsutil/crc5.h
@@ -1,4 +1,4 @@
-/* crc5.h
+/** @file
* Declaration of CRC-5 routines and table
*
* 2019 Tomasz Mon <desowin@gmail.com>
diff --git a/wsutil/crc6.h b/wsutil/crc6.h
index f9c187f2a8..e177ed01e9 100644
--- a/wsutil/crc6.h
+++ b/wsutil/crc6.h
@@ -1,5 +1,4 @@
-/*
- * crc6.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/wsutil/crc7.h b/wsutil/crc7.h
index adb35aac0f..fd5857737f 100644
--- a/wsutil/crc7.h
+++ b/wsutil/crc7.h
@@ -1,5 +1,4 @@
-/*
- * crc7.h
+/** @file
*
* Functions and types for CRC checks.
*
diff --git a/wsutil/crc8.h b/wsutil/crc8.h
index 269fbc2ea4..1b5a7721e2 100644
--- a/wsutil/crc8.h
+++ b/wsutil/crc8.h
@@ -1,4 +1,4 @@
-/* crc8.h
+/** @file
* Declaration of CRC-8 routine and tables
*
* 2011 Roland Knall <rknall@gmail.com>
diff --git a/wsutil/curve25519.h b/wsutil/curve25519.h
index fc6a28450a..387ee29f5d 100644
--- a/wsutil/curve25519.h
+++ b/wsutil/curve25519.h
@@ -1,4 +1,4 @@
-/* curve25519.h
+/** @file
* NaCl/Sodium-compatible API for Curve25519 cryptography.
*
* Copyright (c) 2018, Peter Wu <peter@lekensteyn.nl>
diff --git a/wsutil/eax.h b/wsutil/eax.h
index bc7118c290..252b81208d 100644
--- a/wsutil/eax.h
+++ b/wsutil/eax.h
@@ -1,4 +1,4 @@
-/* eax.h
+/** @file
* Encryption and decryption routines implementing the EAX' encryption mode
* Copyright 2010, Edward J. Beroset, edward.j.beroset@us.elster.com
*
diff --git a/wsutil/file_util.h b/wsutil/file_util.h
index f68dc53615..12ad3a1693 100644
--- a/wsutil/file_util.h
+++ b/wsutil/file_util.h
@@ -1,4 +1,4 @@
-/* file_util.h
+/** @file
* File utility definitions
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/filesystem.h b/wsutil/filesystem.h
index d648e197e9..2a7f95647d 100644
--- a/wsutil/filesystem.h
+++ b/wsutil/filesystem.h
@@ -1,4 +1,4 @@
-/* filesystem.h
+/** @file
* Filesystem utility definitions
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/g711.h b/wsutil/g711.h
index 81e66bede1..d5196da89e 100644
--- a/wsutil/g711.h
+++ b/wsutil/g711.h
@@ -1,5 +1,4 @@
-/*
- * g711.h
+/** @file
*
* Definitions for routines for u-law, A-law and linear PCM conversions
*
diff --git a/wsutil/inet_addr.h b/wsutil/inet_addr.h
index 378cf49b4e..5bc4e7ea9f 100644
--- a/wsutil/inet_addr.h
+++ b/wsutil/inet_addr.h
@@ -1,4 +1,4 @@
-/* inet_addr.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/wsutil/interface.h b/wsutil/interface.h
index ee9ab1c0a0..5c431bfa0e 100644
--- a/wsutil/interface.h
+++ b/wsutil/interface.h
@@ -1,4 +1,4 @@
-/* interface.c
+/** @file
* Utility functions to get infos from interfaces
*
* Copyright 2016, Dario Lombardo
diff --git a/wsutil/json_dumper.h b/wsutil/json_dumper.h
index 3ed7563e2a..bc382c3524 100644
--- a/wsutil/json_dumper.h
+++ b/wsutil/json_dumper.h
@@ -1,4 +1,4 @@
-/* wsjson.h
+/** @file
* Routines for serializing data as JSON.
*
* Copyright 2018, Peter Wu <peter@lekensteyn.nl>
diff --git a/wsutil/mpeg-audio.h b/wsutil/mpeg-audio.h
index ce102117e4..ced51ff745 100644
--- a/wsutil/mpeg-audio.h
+++ b/wsutil/mpeg-audio.h
@@ -1,4 +1,4 @@
-/* mpeg-audio.h
+/** @file
*
* MPEG Audio header dissection
* Written by Shaun Jackman <sjackman@gmail.com>
diff --git a/wsutil/os_version_info.h b/wsutil/os_version_info.h
index a56c132e4f..825e801873 100644
--- a/wsutil/os_version_info.h
+++ b/wsutil/os_version_info.h
@@ -1,4 +1,4 @@
-/* os_version_info.h
+/** @file
* Declarations of outines to report operating system version information
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/please_report_bug.h b/wsutil/please_report_bug.h
index 508bf5a1a5..e99b26ca2a 100644
--- a/wsutil/please_report_bug.h
+++ b/wsutil/please_report_bug.h
@@ -1,4 +1,4 @@
-/* please_report_bug.h
+/** @file
* Declarations of routines returning strings to use when reporting a bug.
* They ask the user to report a bug to the Wireshark developers.
*
diff --git a/wsutil/plugins.h b/wsutil/plugins.h
index a971e869f8..2cf2c4e80d 100644
--- a/wsutil/plugins.h
+++ b/wsutil/plugins.h
@@ -1,4 +1,4 @@
-/* plugins.h
+/** @file
* definitions for plugins structures
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/privileges.h b/wsutil/privileges.h
index 3a6169e434..4c712bbf32 100644
--- a/wsutil/privileges.h
+++ b/wsutil/privileges.h
@@ -1,4 +1,4 @@
-/* privileges.h
+/** @file
* Declarations of routines for handling privileges.
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/report_message.h b/wsutil/report_message.h
index 76078d3879..a282a8be00 100644
--- a/wsutil/report_message.h
+++ b/wsutil/report_message.h
@@ -1,4 +1,4 @@
-/* report_message.h
+/** @file
* Declarations of routines for code that can run in GUI and command-line
* environments to use to report errors and warnings to the user (e.g.,
* I/O errors, or problems with preference settings) if the message should
diff --git a/wsutil/rsa.h b/wsutil/rsa.h
index 07ddf8547a..8d51c4b2ba 100644
--- a/wsutil/rsa.h
+++ b/wsutil/rsa.h
@@ -1,4 +1,4 @@
-/* rsa.h
+/** @file
*
* Functions for RSA private key reading and use
*
diff --git a/wsutil/socket.h b/wsutil/socket.h
index 8d89b24267..8387ecf2f4 100644
--- a/wsutil/socket.h
+++ b/wsutil/socket.h
@@ -1,4 +1,4 @@
-/* socket.h
+/** @file
* Socket wrappers
*
* Copyright 2016, Dario Lombardo
diff --git a/wsutil/str_util.h b/wsutil/str_util.h
index 07e929dff7..8a2eaabce8 100644
--- a/wsutil/str_util.h
+++ b/wsutil/str_util.h
@@ -1,4 +1,4 @@
-/* str_util.h
+/** @file
* String utility definitions
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/strnatcmp.h b/wsutil/strnatcmp.h
index 8f6b7828ef..0ebe1f6f4f 100644
--- a/wsutil/strnatcmp.h
+++ b/wsutil/strnatcmp.h
@@ -1,4 +1,4 @@
-/* strnatcmp.h
+/** @file
*
* Original code downloaded from: http://sourcefrog.net/projects/natsort/
diff --git a/wsutil/strptime.h b/wsutil/strptime.h
index af5baabbc6..43671a4af3 100644
--- a/wsutil/strptime.h
+++ b/wsutil/strptime.h
@@ -1,4 +1,4 @@
-/* strptime.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/wsutil/strtoi.h b/wsutil/strtoi.h
index 6e2fabed07..516eeb5519 100644
--- a/wsutil/strtoi.h
+++ b/wsutil/strtoi.h
@@ -1,4 +1,4 @@
-/* strtoi.h
+/** @file
* Utilities to convert strings to integers
*
* Copyright 2016, Dario Lombardo
diff --git a/wsutil/time_util.h b/wsutil/time_util.h
index 40914d29a5..ef15c5e5d8 100644
--- a/wsutil/time_util.h
+++ b/wsutil/time_util.h
@@ -1,4 +1,4 @@
-/* time_util.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/wsutil/type_util.h b/wsutil/type_util.h
index 0944a494e1..021c6b946d 100644
--- a/wsutil/type_util.h
+++ b/wsutil/type_util.h
@@ -1,4 +1,4 @@
-/* type_util.h
+/** @file
* Types utility definitions
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/wmem/wmem_array.h b/wsutil/wmem/wmem_array.h
index 8f57fa4c2f..0e82e66e74 100644
--- a/wsutil/wmem/wmem_array.h
+++ b/wsutil/wmem/wmem_array.h
@@ -1,4 +1,4 @@
-/* wmem_array.h
+/** @file
* Definitions for the Wireshark Memory Manager Array
* Copyright 2013, Evan Huus <eapache@gmail.com>
*
diff --git a/wsutil/wmem/wmem_core.h b/wsutil/wmem/wmem_core.h
index 479cbee4ac..2b0f09a82b 100644
--- a/wsutil/wmem/wmem_core.h
+++ b/wsutil/wmem/wmem_core.h
@@ -1,4 +1,4 @@
-/* wmem_core.h
+/** @file
* Definitions for the Wireshark Memory Manager Core
* Copyright 2012, Evan Huus <eapache@gmail.com>
*
diff --git a/wsutil/wmem/wmem_interval_tree.h b/wsutil/wmem/wmem_interval_tree.h
index 5fb3172e5a..128455faf1 100644
--- a/wsutil/wmem/wmem_interval_tree.h
+++ b/wsutil/wmem/wmem_interval_tree.h
@@ -1,4 +1,4 @@
-/* wmem_interval_tree.h
+/** @file
* Definitions for the Wireshark Memory Manager Red-Black Tree
* Based on the red-black tree implementation in epan/emem.*
* Copyright 2015, Matthieu coudron <matthieu.coudron@lip6.fr>
diff --git a/wsutil/wmem/wmem_list.h b/wsutil/wmem/wmem_list.h
index db17df0ba7..edfc018417 100644
--- a/wsutil/wmem/wmem_list.h
+++ b/wsutil/wmem/wmem_list.h
@@ -1,4 +1,4 @@
-/* wmem_list.h
+/** @file
* Definitions for the Wireshark Memory Manager Doubly-Linked List
* Copyright 2012, Evan Huus <eapache@gmail.com>
*
diff --git a/wsutil/wmem/wmem_map.h b/wsutil/wmem/wmem_map.h
index 86c6d529b2..b3de5061c8 100644
--- a/wsutil/wmem/wmem_map.h
+++ b/wsutil/wmem/wmem_map.h
@@ -1,4 +1,4 @@
-/* wmem_map.h
+/** @file
* Definitions for the Wireshark Memory Manager Hash Map
* Copyright 2014, Evan Huus <eapache@gmail.com>
*
diff --git a/wsutil/wmem/wmem_miscutl.h b/wsutil/wmem/wmem_miscutl.h
index 92ce5c9be6..125f49379f 100644
--- a/wsutil/wmem/wmem_miscutl.h
+++ b/wsutil/wmem/wmem_miscutl.h
@@ -1,4 +1,4 @@
-/* wmem_miscutl.h
+/** @file
* Definitions for the Wireshark Memory Manager Misc Utilities
* Copyright 2013, Evan Huus <eapache@gmail.com>
*
diff --git a/wsutil/wmem/wmem_stack.h b/wsutil/wmem/wmem_stack.h
index 9a30de511e..b4fd2d5676 100644
--- a/wsutil/wmem/wmem_stack.h
+++ b/wsutil/wmem/wmem_stack.h
@@ -1,4 +1,4 @@
-/* wmem_stack.h
+/** @file
* Definitions for the Wireshark Memory Manager Stack
* Copyright 2012, Evan Huus <eapache@gmail.com>
*
diff --git a/wsutil/wmem/wmem_strbuf.h b/wsutil/wmem/wmem_strbuf.h
index 95559499f9..55f2b77292 100644
--- a/wsutil/wmem/wmem_strbuf.h
+++ b/wsutil/wmem/wmem_strbuf.h
@@ -1,4 +1,4 @@
-/* wmem_strbuf.h
+/** @file
* Definitions for the Wireshark Memory Manager String Buffer
* Copyright 2012, Evan Huus <eapache@gmail.com>
*
diff --git a/wsutil/wmem/wmem_strutl.h b/wsutil/wmem/wmem_strutl.h
index 87963a77b3..531867ac86 100644
--- a/wsutil/wmem/wmem_strutl.h
+++ b/wsutil/wmem/wmem_strutl.h
@@ -1,4 +1,4 @@
-/* wmem_strutl.h
+/** @file
* Definitions for the Wireshark Memory Manager String Utilities
* Copyright 2012, Evan Huus <eapache@gmail.com>
*
diff --git a/wsutil/wmem/wmem_tree.h b/wsutil/wmem/wmem_tree.h
index 51f3c9908b..c12d45c37e 100644
--- a/wsutil/wmem/wmem_tree.h
+++ b/wsutil/wmem/wmem_tree.h
@@ -1,4 +1,4 @@
-/* wmem_tree.h
+/** @file
* Definitions for the Wireshark Memory Manager Red-Black Tree
* Based on the red-black tree implementation in epan/emem.*
* Copyright 2013, Evan Huus <eapache@gmail.com>
diff --git a/wsutil/wmem/wmem_user_cb.h b/wsutil/wmem/wmem_user_cb.h
index e107dcdaa9..236f55ebb1 100644
--- a/wsutil/wmem/wmem_user_cb.h
+++ b/wsutil/wmem/wmem_user_cb.h
@@ -1,4 +1,4 @@
-/* wmem_user_cb.h
+/** @file
* Definitions for the Wireshark Memory Manager User Callbacks
* Copyright 2012, Evan Huus <eapache@gmail.com>
*
diff --git a/wsutil/ws_assert.h b/wsutil/ws_assert.h
index 90e4647279..9ba1d2ec37 100644
--- a/wsutil/ws_assert.h
+++ b/wsutil/ws_assert.h
@@ -1,4 +1,4 @@
-/* ws_assert.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/wsutil/ws_getopt.h b/wsutil/ws_getopt.h
index 3f49de4415..b32badceac 100644
--- a/wsutil/ws_getopt.h
+++ b/wsutil/ws_getopt.h
@@ -1,4 +1,5 @@
-/*
+/** @file
+ *
* musl as a whole is licensed under the following standard MIT license:
*
* ----------------------------------------------------------------------
diff --git a/wsutil/ws_mempbrk.h b/wsutil/ws_mempbrk.h
index 80bceb4523..dddcc12b01 100644
--- a/wsutil/ws_mempbrk.h
+++ b/wsutil/ws_mempbrk.h
@@ -1,4 +1,4 @@
-/* ws_mempbrk.h
+/** @file
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
diff --git a/wsutil/ws_pipe.h b/wsutil/ws_pipe.h
index 35a189097e..d3f8931144 100644
--- a/wsutil/ws_pipe.h
+++ b/wsutil/ws_pipe.h
@@ -1,4 +1,4 @@
-/* ws_pipe.h
+/** @file
*
* Routines for handling pipes.
*
diff --git a/wsutil/wsgcrypt.h b/wsutil/wsgcrypt.h
index 6099667780..493540d64a 100644
--- a/wsutil/wsgcrypt.h
+++ b/wsutil/wsgcrypt.h
@@ -1,4 +1,4 @@
-/* wsgcrypt.h
+/** @file
*
* Wrapper around libgcrypt's include file gcrypt.h.
* For libgcrypt 1.5.0, including gcrypt.h directly brings up lots of
diff --git a/wsutil/wsjson.h b/wsutil/wsjson.h
index 1e0028c57b..b6fa031761 100644
--- a/wsutil/wsjson.h
+++ b/wsutil/wsjson.h
@@ -1,4 +1,5 @@
-/* wsjson.h
+/** @file
+ *
* JSON parsing functions.
*
* Copyright 2016, Dario Lombardo
diff --git a/wsutil/wslog.h b/wsutil/wslog.h
index a5e507a6db..e52c18625b 100644
--- a/wsutil/wslog.h
+++ b/wsutil/wslog.h
@@ -1,4 +1,5 @@
-/*
+/** @file
+ *
* Copyright 2021, João Valverde <j@v6e.pt>
*
* Wireshark - Network traffic analyzer
diff --git a/wsutil/xtea.h b/wsutil/xtea.h
index 09a467cab3..af914f2613 100644
--- a/wsutil/xtea.h
+++ b/wsutil/xtea.h
@@ -1,4 +1,5 @@
-/* xtea.h
+/** @file
+ *
* Implementation of XTEA cipher
* By Ahmad Fatoum <ahmad[AT]a3f.at>
* Copyright 2017 Ahmad Fatoum