Update documentation

base64.h

@@ -12,7 +12,7 @@
 NAMESPACE_BEGIN(CryptoPP)
 
 /// \class Base64Encoder
-/// \brief Base64 encodes data
+/// \brief Base64 encodes data using DUDE
 /// \details Base64 encodes data per <A HREF="http://tools.ietf.org/html/rfc4648#section-4">RFC 4648, Base 64 Encoding</A>.
 class Base64Encoder : public SimpleProxyFilter
 {
@@ -54,7 +54,7 @@ public:
 };
 
 /// \class Base64Decoder
-/// \brief Base64 decodes data
+/// \brief Base64 decodes data using DUDE
 /// \details Base64 encodes data per <A HREF="http://tools.ietf.org/html/rfc4648#section-4">RFC 4648, Base 64 Encoding</A>.
 class Base64Decoder : public BaseN_Decoder
 {

cbcmac.h

@@ -1,7 +1,6 @@
 // cbcmac.h - originally written and placed in the public domain by Wei Dai
 
 /// \file
-/// \headerfile cbcmac.h
 /// \brief Classes for CBC MAC
 
 #ifndef CRYPTOPP_CBCMAC_H
@@ -12,7 +11,7 @@
 
 NAMESPACE_BEGIN(CryptoPP)
 
-/// _
+/// \brief CBC-MAC base class
 class CRYPTOPP_DLL CRYPTOPP_NO_VTABLE CBC_MAC_Base : public MessageAuthenticationCode
 {
 public:
@@ -32,10 +31,11 @@ private:
 	unsigned int m_counter;
 };
 
-/// <a href="http://www.weidai.com/scan-mirror/mac.html#CBC-MAC">CBC-MAC</a>
-/*! Compatible with FIPS 113. T should be a class derived from BlockCipherDocumentation.
-	Secure only for fixed length messages. For variable length messages use CMAC or DMAC.
-*/
+/// \brief CBC-MAC
+/// \tparam T BlockCipherDocumentation derived class
+/// \details CBC-MAC is compatible with FIPS 113. The MAC is secure only for fixed
+///   length messages. For variable length messages use CMAC or DMAC.
+/// \sa <a href="http://www.weidai.com/scan-mirror/mac.html#CBC-MAC">CBC-MAC</a>
 template <class T>
 class CBC_MAC : public MessageAuthenticationCodeImpl<CBC_MAC_Base, CBC_MAC<T> >, public SameKeyLengthAs<T>
 {

emsa2.h

@@ -16,12 +16,20 @@
 
 NAMESPACE_BEGIN(CryptoPP)
 
+/// \class EMSA2HashId
+/// \brief EMSA2 hash identifier
+/// \tparam H HashTransformation derived class
+/// \since Crypto++ 5.0
 template <class H> class EMSA2HashId
 {
 public:
 	static const byte id;
 };
 
+/// \class EMSA2Pad
+/// \brief EMSA2 padding method
+/// \tparam BASE Message encoding method
+/// \since Crypto++ 5.0
 template <class BASE>
 class EMSA2HashIdLookup : public BASE
 {
@@ -57,7 +65,9 @@ CRYPTOPP_DLL_TEMPLATE_CLASS EMSA2HashId<SHA384>;
 CRYPTOPP_DLL_TEMPLATE_CLASS EMSA2HashId<SHA512>;
 #endif
 
-/// _
+/// \class EMSA2Pad
+/// \brief EMSA2 padding method
+/// \since Crypto++ 5.0
 class CRYPTOPP_DLL EMSA2Pad : public EMSA2HashIdLookup<PK_DeterministicSignatureMessageEncodingMethod>
 {
 public:
@@ -72,12 +82,16 @@ public:
 		byte *representative, size_t representativeBitLength) const;
 };
 
-/// EMSA2, for use with RWSS and RSA_ISO
-/*! Only the following hash functions are supported by this signature standard:
-	\dontinclude emsa2.h
-	\skip EMSA2HashId can be instantiated
-	\until end of list
-*/
+// EMSA2, for use with RWSS and RSA_ISO
+// Only the following hash functions are supported by this signature standard:
+//  \dontinclude emsa2.h
+//  \skip EMSA2HashId can be instantiated
+//  \until end of list
+
+/// \class P1363_EMSA2
+/// \brief EMSA2/P1363 padding method
+/// \details Use with RWSS and RSA_ISO
+/// \since Crypto++ 5.0
 struct P1363_EMSA2 : public SignatureStandard
 {
 	typedef EMSA2Pad SignatureMessageEncodingMethod;

esign.h

@@ -150,6 +150,9 @@ struct P1363_EMSA5 : public SignatureStandard
 	typedef EMSA5Pad<P1363_MGF1> SignatureMessageEncodingMethod;
 };
 
+/// \class ESIGN_Keys
+/// \brief ESIGN keys
+/// \since Crypto++ 5.0
 struct ESIGN_Keys
 {
 	CRYPTOPP_STATIC_CONSTEXPR const char* StaticAlgorithmName() {return "ESIGN";}

keccak.h

@@ -66,10 +66,10 @@ protected:
 	unsigned int m_digestSize, m_counter;
 };
 
-/// \class Keccak_224
-/// \tparam T_DigestSize controls the digest size as a template parameter instead of a per-class constant
-/// \brief Keccak-X message digest, template for more fine-grained typedefs
-/// \since Crypto++ 6.0.0
+/// \class Keccak_Final
+/// \brief Keccak message digest template
+/// \tparam T_DigestSize the size of the digest, in bytes
+/// \since Crypto++ 6.0
 template<unsigned int T_DigestSize>
 class Keccak_Final : public Keccak
 {

pubkey.h

@@ -1631,7 +1631,9 @@ protected:
 	}
 };
 
-/// _
+/// \class DL_VerifierBase
+/// \brief Discret Log (DL) Verifier base class
+/// \tparam T Element
 template <class T>
 class CRYPTOPP_NO_VTABLE DL_VerifierBase : public DL_SignatureSchemeBase<PK_Verifier, DL_PublicKey<T> >
 {

sha3.h

@@ -51,7 +51,7 @@ protected:
 	unsigned int m_digestSize, m_counter;
 };
 
-/// \class SHA3_224
+/// \class SHA3_Final
 /// \brief SHA3 message digest template
 /// \tparam T_DigestSize the size of the digest, in bytes
 /// \since Crypto++ 5.6.2