From d4293182301772b9ce2a2020117b77905639c0f5 Mon Sep 17 00:00:00 2001
From: Jeffrey Walton <noloader@gmail.com>
Date: Mon, 22 Jan 2018 09:53:49 -0500
Subject: [PATCH] Cleanup Doxygen directives

---
 adler32.h  | 3 +--
 blumshub.h | 3 +--
 channels.h | 3 +--
 crc.h      | 3 +--
 dll.h      | 3 +--
 dmac.h     | 7 +++----
 ec2n.h     | 3 +--
 misc.cpp   | 2 +-
 pch.h      | 3 ++-
 9 files changed, 12 insertions(+), 18 deletions(-)

diff --git a/adler32.h b/adler32.h
index 0b906615..d7f0f283 100644
--- a/adler32.h
+++ b/adler32.h
@@ -1,7 +1,6 @@
 // adler32.h - originally written and placed in the public domain by Wei Dai
 
-/// \file
-/// \headerfile adler32.h
+/// \file adler32.h
 /// \brief Class file for ADLER-32 checksum calculations
 
 #ifndef CRYPTOPP_ADLER32_H
diff --git a/blumshub.h b/blumshub.h
index 1827f47b..9297c942 100644
--- a/blumshub.h
+++ b/blumshub.h
@@ -1,7 +1,6 @@
 // blumshub.h - originally written and placed in the public domain by Wei Dai
 
-/// \file
-/// \headerfile blumshub.h
+/// \file blumshub.h
 /// \brief Classes for Blum Blum Shub generator
 
 #ifndef CRYPTOPP_BLUMSHUB_H
diff --git a/channels.h b/channels.h
index 7da9a813..da470a2b 100644
--- a/channels.h
+++ b/channels.h
@@ -1,7 +1,6 @@
 // channels.h - originally written and placed in the public domain by Wei Dai
 
-/// \file
-/// \headerfile channels.h
+/// \file channels.h
 /// \brief Classes for multiple named channels
 
 #ifndef CRYPTOPP_CHANNELS_H
diff --git a/crc.h b/crc.h
index 08a20a64..f34715f6 100644
--- a/crc.h
+++ b/crc.h
@@ -1,7 +1,6 @@
 // crc.h - originally written and placed in the public domain by Wei Dai
 
-/// \file
-/// \headerfile crc.h
+/// \file crc.h
 /// \brief Classes for CRC-32 and CRC-32C checksum algorithm
 
 #ifndef CRYPTOPP_CRC32_H
diff --git a/dll.h b/dll.h
index bd8acf10..bbb2257a 100644
--- a/dll.h
+++ b/dll.h
@@ -1,7 +1,6 @@
 // dll.h - originally written and placed in the public domain by Wei Dai
 
-/// \file
-/// \headerfile dll.h
+/// \file dll.h
 /// \brief Functions and definitions required for building the FIPS-140 DLL on Windows
 
 #ifndef CRYPTOPP_DLL_H
diff --git a/dmac.h b/dmac.h
index 8d65adf6..62be7ee0 100644
--- a/dmac.h
+++ b/dmac.h
@@ -1,7 +1,6 @@
 // dmac.h - originally written and placed in the public domain by Wei Dai
 
-/// \file
-/// \headerfile dmac.h
+/// \file dmac.h
 /// \brief Classes for DMAC message authentication code
 
 #ifndef CRYPTOPP_DMAC_H
@@ -17,10 +16,10 @@ template <class T>
 class CRYPTOPP_NO_VTABLE DMAC_Base : public SameKeyLengthAs<T>, public MessageAuthenticationCode
 {
 public:
+	CRYPTOPP_CONSTANT(DIGESTSIZE=T::BLOCKSIZE)
 	static std::string StaticAlgorithmName() {return std::string("DMAC(") + T::StaticAlgorithmName() + ")";}
 
-	CRYPTOPP_CONSTANT(DIGESTSIZE=T::BLOCKSIZE)
-
+	virtual~DMAC_Base() {}
 	DMAC_Base() : m_subkeylength(0), m_counter(0) {}
 
 	void UncheckedSetKey(const byte *key, unsigned int length, const NameValuePairs &params);
diff --git a/ec2n.h b/ec2n.h
index 25ac334e..95697926 100644
--- a/ec2n.h
+++ b/ec2n.h
@@ -1,7 +1,6 @@
 // ec2n.h - originally written and placed in the public domain by Wei Dai
 
-/// \file
-/// \headerfile ec2n.h
+/// \file ec2n.h
 /// \brief Classes for Elliptic Curves over binary fields
 
 
diff --git a/misc.cpp b/misc.cpp
index 7ebc20df..adc0d4df 100644
--- a/misc.cpp
+++ b/misc.cpp
@@ -322,7 +322,7 @@ void AlignedDeallocate(void *p)
 #endif
 }
 
-#endif
+#endif  // CRYPTOPP_BOOL_ALIGN16
 
 void * UnalignedAllocate(size_t size)
 {
diff --git a/pch.h b/pch.h
index ae544c4c..f158399c 100644
--- a/pch.h
+++ b/pch.h
@@ -1,7 +1,8 @@
 // pch.h - originally written and placed in the public domain by Wei Dai
 
-/// \headerfile pch.h
+/// \file pch.h
 /// \brief Precompiled header file
+/// \details The precompiled header files are used Windows.
 
 #ifndef CRYPTOPP_PCH_H
 #define CRYPTOPP_PCH_H