diff --git a/src/cmd/gc/go.h b/src/cmd/gc/go.h
index 5e929d3c5b..1afd1ca56e 100644
--- a/src/cmd/gc/go.h
+++ b/src/cmd/gc/go.h
@@ -645,20 +645,21 @@ enum
 	Cboth = Crecv | Csend,
 };
 
+// declaration context
 enum
 {
 	Pxxx,
 
-	PEXTERN,	// declaration context
-	PAUTO,
-	PPARAM,
-	PPARAMOUT,
-	PPARAMREF,	// param passed by reference
-	PFUNC,
+	PEXTERN,	// global variable
+	PAUTO,		// local variables
+	PPARAM,		// input arguments
+	PPARAMOUT,	// output results
+	PPARAMREF,	// closure variable reference
+	PFUNC,		// global function
 
 	PDISCARD,	// discard during parse of duplicate import
 
-	PHEAP = 1<<7,
+	PHEAP = 1<<7,	// an extra bit to identify an escaped variable
 };
 
 enum