diff --git a/include/polarssl/compat-1.2.h b/include/polarssl/compat-1.2.h
index f7f3d0019..ca9a8e068 100644
--- a/include/polarssl/compat-1.2.h
+++ b/include/polarssl/compat-1.2.h
@@ -3,6 +3,8 @@
  *
  * \brief Backwards compatibility header for PolarSSL-1.2 from PolarSSL-1.3
  *
+ * \deprecated  Use native PolarSSL 1.3 functions instead.
+ *
  *  Copyright (C) 2006-2013, ARM Limited, All Rights Reserved
  *
  *  This file is part of mbed TLS (https://tls.mbed.org)
diff --git a/include/polarssl/config.h b/include/polarssl/config.h
index a811f8b60..be7da2850 100644
--- a/include/polarssl/config.h
+++ b/include/polarssl/config.h
@@ -650,11 +650,9 @@
  * Make available the backward compatible error_strerror() next to the
  * current polarssl_strerror().
  *
- * For new code, it is recommended to use polarssl_strerror() instead and
- * disable this.
+ * \deprecated Do not define this and use polarssl_strerror() instead
  *
- * Disable if you run into name conflicts and want to really remove the
- * error_strerror()
+ * Disable if you want to really remove the error_strerror() name
  */
 #define POLARSSL_ERROR_STRERROR_BC
 
diff --git a/include/polarssl/openssl.h b/include/polarssl/openssl.h
index 63c16e5cc..dc0eba4d2 100644
--- a/include/polarssl/openssl.h
+++ b/include/polarssl/openssl.h
@@ -3,6 +3,8 @@
  *
  * \brief OpenSSL wrapper (definitions, inline functions).
  *
+ * \deprecated Use native mbed TLS functions instead
+ *
  *  Copyright (C) 2006-2010, ARM Limited, All Rights Reserved
  *
  *  This file is part of mbed TLS (https://tls.mbed.org)