diff --git a/include/polarssl/pem.h b/include/polarssl/pem.h
index 969faa2..782b235 100644
--- a/include/polarssl/pem.h
+++ b/include/polarssl/pem.h
@@ -84,6 +84,9 @@
  *                  POLARSSL_ERR_PEM_NO_HEADER_FOOTER_PRESENT, use_len is
  *                  the length to skip)
  *
+ * \note            Checks password correctness by verifying if the decrypted
+ *                  text looks like a RSAPrivateKey or ECPrivateKey structure
+ *
  * \return          0 on success, ior a specific PEM error code
  */
 int pem_read_buffer( pem_context *ctx, const char *header, const char *footer,