cmd/cgo: document CGO_LDFLAGS and CGO_CFLAGS

Fixes #3203.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5769043

diff --git a/src/cmd/cgo/doc.go b/src/cmd/cgo/doc.go
index 109b666bdc953d4dacec50af49fec35e2337c892..2c261b5f459113cbfa6053e5084b0aa056c83583 100644 (file)
--- a/src/cmd/cgo/doc.go
+++ b/src/cmd/cgo/doc.go
@@ -44,6 +44,11 @@ For example:
        // #include <png.h>
        import "C"
 
+The CGO_CFLAGS and CGO_LDFLAGS environment variables are added
+to the flags derived from these directives.  Package-specific flags should
+be set using the directives, not the environment variables, so that builds
+work in unmodified environments.
+
 Within the Go file, C identifiers or field names that are keywords in Go
 can be accessed by prefixing them with an underscore: if x points at a C
 struct with a field named "type", x._type accesses the field.