Index: src/AST/Expr.hpp
===================================================================
--- src/AST/Expr.hpp	(revision a056f56794da880f8c293f2c3c87427b6dfe1cb6)
+++ src/AST/Expr.hpp	(revision bb87dd060ba10687cd7993c1a11ded9b3eb67786)
@@ -299,5 +299,13 @@
 };
 
-/// Whether a cast existed in the program source or not
+/// Inidicates whether the cast is introduced by the CFA type system.
+/// GeneratedCast for casts that the resolver introduces to force a return type
+/// ExplicitCast for casts from user code
+/// ExplicitCast for casts from desugaring advanced CFA features into simpler CFA
+/// example
+///   int * p;     // declaration
+///   (float *) p; // use, with subject cast
+/// subject cast being GeneratedCast means we are considering an interpretation with a type mismatch
+/// subject cast being ExplicitCast means someone in charge wants it that way
 enum GeneratedFlag { ExplicitCast, GeneratedCast };