Index: src/AST/Expr.hpp
===================================================================
--- src/AST/Expr.hpp	(revision e5c38112cf0116f0fcdd3e08dd4133429b2ecfbe)
+++ src/AST/Expr.hpp	(revision 4702a2cac45f6559d5d3404ee4ce0c09192620f3)
@@ -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 };