diff --git a/lib/krb5/doxygen.c b/lib/krb5/doxygen.c
index 18f5323f6..15b0c43dc 100644
--- a/lib/krb5/doxygen.c
+++ b/lib/krb5/doxygen.c
@@ -96,6 +96,9 @@
  * structure, including default encryption types, credential cache
  * (for example, a ticket file), and default realms.
  *
+ * The internals of the structure should never be accessed directly,
+ * functions exist for extracting information.
+ *
  * See the manual page for krb5_init_context() how to create a context
  * and module @ref krb5 for more information about the functions.
  *