diff --git a/base32.h b/base32.h
index 61ce3e85..7818a220 100644
--- a/base32.h
+++ b/base32.h
@@ -13,8 +13,8 @@
 NAMESPACE_BEGIN(CryptoPP)
 
 //! \class Base32Encoder
-//! \brief Base32 encodes data
-//! \details Converts data to base32. The default code is based on <A HREF="http://www.ietf.org/proceedings/51/I-D/draft-ietf-idn-dude-02.txt">Differential Unicode Domain Encoding (DUDE) (draft-ietf-idn-dude-02.txt)</A>.
+//! \brief Base32 encodes data using DUDE encoding
+//! \details Converts data to base32 using DUDE encoding. The default code is based on <A HREF="http://www.ietf.org/proceedings/51/I-D/draft-ietf-idn-dude-02.txt">Differential Unicode Domain Encoding (DUDE) (draft-ietf-idn-dude-02.txt)</A>.
 //! \sa Base32Encoder, Base32Decoder, Base32HexEncoder and Base32HexDecoder
 class Base32Encoder : public SimpleProxyFilter
 {
@@ -58,8 +58,8 @@ public:
 };
 
 //! \class Base32Decoder
-//! \brief Base32 decodes data
-//! \details Decode base32 data. The default code is based on <A HREF="http://www.ietf.org/proceedings/51/I-D/draft-ietf-idn-dude-02.txt">Differential Unicode Domain Encoding (DUDE) (draft-ietf-idn-dude-02.txt)</A>.
+//! \brief Base32 decodes data using DUDE encoding
+//! \details Converts data from base32 using DUDE encoding. The default code is based on <A HREF="http://www.ietf.org/proceedings/51/I-D/draft-ietf-idn-dude-02.txt">Differential Unicode Domain Encoding (DUDE) (draft-ietf-idn-dude-02.txt)</A>.
 //! \sa Base32Encoder, Base32Decoder, Base32HexEncoder and Base32HexDecoder
 class Base32Decoder : public BaseN_Decoder
 {
@@ -131,8 +131,8 @@ public:
 };
 
 //! \class Base32HexDecoder
-//! \brief Base32 extended hex decodes data
-//! \brief Base32 decodes data using extended hex alphabet. The alphabet is different than Base32Decoder.
+//! \brief Base32 decodes data using extended hex
+//! \details Converts data from base32 using extended hex alphabet. The alphabet is different than Base32Decoder.
 //! \sa Base32Encoder, Base32Decoder, Base32HexEncoder and Base32HexDecoder, <A HREF="http://tools.ietf.org/html/rfc4648#page-10">RFC 4648, Base 32 Encoding with Extended Hex Alphabet</A>.
 //! \since Crypto++ 6.0
 class Base32HexDecoder : public BaseN_Decoder
diff --git a/cryptlib.h b/cryptlib.h
index a954b7c6..644f4790 100644
--- a/cryptlib.h
+++ b/cryptlib.h
@@ -60,11 +60,12 @@
 <dt>Wrappers for OS features<dd>
 	Timer, Socket, WindowsHandle, ThreadLocalStorage, ThreadUserTimer
 
+</dl>
+
 <!--
 
 <dt>FIPS 140 validated cryptography<dd>
 	fips140.h
-</dl>
 
 In the DLL version of Crypto++, only the following implementation class are available.
 <dl>