2 files changed, 15 insertions, 0 deletions
diff --git a/src/pubkey/dl_algo/dl_algo.h b/src/pubkey/dl_algo/dl_algo.h
index 429bfb554..2cc632caa 100644
--- a/src/pubkey/dl_algo/dl_algo.h
+++ b/src/pubkey/dl_algo/dl_algo.h
@@ -67,7 +67,15 @@ class BOTAN_DLL DL_Scheme_PublicKey : public virtual Public_Key
 
    protected:
       DL_Scheme_PublicKey() {}
+
+      /**
+      * The DL public key
+      */
       BigInt y;
+
+      /**
+      * The DL group
+      */
       DL_Group group;
    };
 
@@ -94,6 +102,10 @@ class BOTAN_DLL DL_Scheme_PrivateKey : public virtual DL_Scheme_PublicKey,
 
    protected:
       DL_Scheme_PrivateKey() {}
+
+      /**
+      * The DL private key
+      */
       BigInt x;
    };
 
diff --git a/src/pubkey/pkcs8.h b/src/pubkey/pkcs8.h
index 3da96d840..376429d5b 100644
--- a/src/pubkey/pkcs8.h
+++ b/src/pubkey/pkcs8.h
@@ -22,6 +22,9 @@ struct BOTAN_DLL PKCS8_Exception : public Decoding_Error
       Decoding_Error("PKCS #8: " + error) {}
    };
 
+/**
+* This namespace contains functions for handling PKCS #8 private keys
+*/
 namespace PKCS8 {
 
 /**