diff --git a/library/x509.c b/library/x509.c
index 4ed8a4d..627a5a3 100644
--- a/library/x509.c
+++ b/library/x509.c
@@ -348,6 +348,8 @@
  *  AttributeType ::= OBJECT IDENTIFIER
  *
  *  AttributeValue ::= ANY DEFINED BY AttributeType
+ *
+ *  NOTE: This function returns an ASN.1 low-level error code.
  */
 static int x509_get_attr_type_value( unsigned char **p,
                                      const unsigned char *end,
@@ -423,6 +425,8 @@
  * For the general case we still use a flat list, but we mark elements of the
  * same set so that they are "merged" together in the functions that consume
  * this list, eg mbedtls_x509_dn_gets().
+ *
+ * NOTE: This function returns an ASN.1 low-level error code.
  */
 static int x509_set_sequence_iterate( unsigned char **p,
                                       unsigned char const **end_set,
@@ -446,6 +450,7 @@
         *end_set = *p + set_len;
     }
 
+    /* x509_get_attr_type_value() returns ASN.1 low-level error codes. */
     ret = x509_get_attr_type_value( p, *end_set, oid, val );
 
 exit: