Add a justification for early md.h include in programs

Signed-off-by: Andrzej Kurek <andrzej.kurek@arm.com>

programs/pkey/dh_server.c

@@ -20,6 +20,7 @@
 #include "mbedtls/build_info.h"
 
 #include "mbedtls/platform.h"
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #if defined(MBEDTLS_AES_C) && defined(MBEDTLS_DHM_C) && \

programs/pkey/pk_sign.c

@@ -20,6 +20,7 @@
 #include "mbedtls/build_info.h"
 
 #include "mbedtls/platform.h"
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #if !defined(MBEDTLS_BIGNUM_C) || !defined(MBEDTLS_ENTROPY_C) ||  \

programs/pkey/pk_verify.c

@@ -20,6 +20,7 @@
 #include "mbedtls/build_info.h"
 
 #include "mbedtls/platform.h"
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #if !defined(MBEDTLS_BIGNUM_C) || !defined(MBEDTLS_MD_C) || \

programs/pkey/rsa_sign.c

@@ -20,6 +20,7 @@
 #include "mbedtls/build_info.h"
 
 #include "mbedtls/platform.h"
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #if !defined(MBEDTLS_BIGNUM_C) || !defined(MBEDTLS_RSA_C) ||  \

programs/pkey/rsa_sign_pss.c

@@ -20,6 +20,7 @@
 #include "mbedtls/build_info.h"
 
 #include "mbedtls/platform.h"
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #if !defined(MBEDTLS_MD_C) || !defined(MBEDTLS_ENTROPY_C) ||  \

programs/pkey/rsa_verify.c

@@ -20,6 +20,7 @@
 #include "mbedtls/build_info.h"
 
 #include "mbedtls/platform.h"
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #if !defined(MBEDTLS_BIGNUM_C) || !defined(MBEDTLS_RSA_C) ||  \

programs/pkey/rsa_verify_pss.c

@@ -20,6 +20,7 @@
 #include "mbedtls/build_info.h"
 
 #include "mbedtls/platform.h"
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #if !defined(MBEDTLS_MD_C) || !defined(MBEDTLS_ENTROPY_C) ||  \

programs/psa/key_ladder_demo.c

@@ -58,6 +58,7 @@
 
 #include "mbedtls/platform.h" // for mbedtls_setbuf
 #include "mbedtls/platform_util.h" // for mbedtls_platform_zeroize
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #include <psa/crypto.h>

programs/x509/cert_req.c

@@ -20,6 +20,7 @@
 #include "mbedtls/build_info.h"
 
 #include "mbedtls/platform.h"
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #if !defined(MBEDTLS_X509_CSR_WRITE_C) || !defined(MBEDTLS_FS_IO) ||  \

programs/x509/cert_write.c

@@ -20,6 +20,7 @@
 #include "mbedtls/build_info.h"
 
 #include "mbedtls/platform.h"
+// md.h is included this early since MD_CAN_XXX macros are defined there.
 #include "mbedtls/md.h"
 
 #if !defined(MBEDTLS_X509_CRT_WRITE_C) || \