diff --git a/include/picotls.h b/include/picotls.h
index 0623d2c..ea01bb0 100644
--- a/include/picotls.h
+++ b/include/picotls.h
@@ -342,11 +342,11 @@
      */
     const char *name;
     /**
-     * confidentiality_limit (max packets sent before re-key)
+     * confidentiality_limit (max records / packets sent before re-key)
      */
     const uint64_t confidentiality_limit;
     /**
-     * integrity_limit (max decryption failure packets before re-key)
+     * integrity_limit (max decryption failure records / packets before re-key)
      */
     const uint64_t integrity_limit;
     /**