Add remaining header files to Doxygen

Add @file markers for remaining
header files so that Doxygen will
generate documentation for them.

cfile.h

@@ -1,4 +1,5 @@
-/* cfile.h
+/** @file
+ *
  * capture_file definition & GUI-independent manipulation
  *
  * Wireshark - Network traffic analyzer

cli_main.h

@@ -1,4 +1,5 @@
-/*
+/** @file
+ *
  * Declaration of the real main routine, for all CLI programs where the
  * main routine should get UTF-8 arguments on Windows.  In those programs,
  * in the file that defines the main routine, include this header and link

file.h

@@ -1,4 +1,5 @@
-/* file.h
+/** @file
+ *
  * Definitions for file structures and routines
  *
  * Wireshark - Network traffic analyzer

fileset.h

@@ -1,4 +1,5 @@
-/* fileset.h
+/** @file
+ *
  * Definitions for routines for file sets.
  *
  * Wireshark - Network traffic analyzer

frame_tvbuff.h

@@ -1,4 +1,5 @@
-/* frame_tvbuff.h
+/** @file
+ *
  * Implements a tvbuff for frame
  *
  * Wireshark - Network traffic analyzer

fuzz/FuzzerInterface.h

@@ -1,3 +1,4 @@
+/** @file */
 /* based on http://llvm.org/svn/llvm-project/compiler-rt/trunk/lib/fuzzer/FuzzerInterface.h r321218 (20 Dec 2017) */
 
 /* http://llvm.org/svn/llvm-project/compiler-rt/trunk/LICENSE.TXT follows */

globals.h

@@ -1,4 +1,5 @@
-/* globals.h
+/** @file
+ *
  * Global defines, etc.
  *
  * Wireshark - Network traffic analyzer

randpkt_core/randpkt_core.h

@@ -1,4 +1,5 @@
-/*
+/** @file
+ *
  * randpkt_core.h
  * ---------
  * Creates random packet traces. Useful for debugging sniffers by testing

ringbuffer.h

@@ -1,4 +1,5 @@
-/* ringbuffer.h
+/** @file
+ *
  * Definitions for capture ringbuffer files
  *
  * Wireshark - Network traffic analyzer

sharkd.h

@@ -1,4 +1,4 @@
-/* sharkd.h
+/** @file
  *
  * Copyright (C) 2016 Jakub Zawadzki
  *

speexdsp/speex_resampler.h

@@ -1,4 +1,6 @@
-/* Copyright (C) 2007 Jean-Marc Valin
+/** @file
+
+   Copyright (C) 2007 Jean-Marc Valin
 
    File: speex_resampler.h
    Resampling code

text2pcap.h

@@ -1,6 +1,4 @@
-/**-*-C-*-**********************************************************************
- *
- * text2pcap.h
+/** @file
  *
  * Utility to convert an ASCII hexdump into a libpcap-format capture file
  *

tools/lemon/cppmagic.h

@@ -1,4 +1,4 @@
-
+/** @file */
 /**************************************** CPP definitions ***************/
 
 /* CPP magic: Concatenate two strings or macros that resolve to strings.

tools/npl/ast.h

@@ -1,4 +1,5 @@
-/*
+/** @file
+ *
  * Copyright 2012-2013, Jakub Zawadzki <darkjames-ws@darkjames.pl>
  *
  * SPDX-License-Identifier: GPL-2.0-or-later

writecap/pcapio.h

@@ -1,4 +1,5 @@
-/* pcapio.h
+/** @file
+ *
  * Declarations of our own routines for writing libpcap files.
  *
  * Wireshark - Network traffic analyzer

wspcap.h

@@ -1,4 +1,4 @@
-/* wspcap.h
+/** @file
  *
  * Wrapper around libpcap/WinPcap's pcap.h.
  *