From: Carl Shapiro <cshapiro@google.com>
Date: Tue, 29 Jan 2013 00:57:36 +0000 (-0800)
Subject: cmd/gc: document more of the declaration context enumeration
X-Git-Tag: go1.1rc2~1266
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=10da5260690e6b41097686f379e1b629ef148dc5;p=gostls13.git

cmd/gc: document more of the declaration context enumeration

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/7231051
---

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