From b3399ac5d19c896452548ca8e99176bcdab78781 Mon Sep 17 00:00:00 2001 From: Ian Lance Taylor Date: Wed, 12 Jun 2019 07:01:04 -0700 Subject: [PATCH] cmd/go: add more docs for go directive in go.mod file Updates #30791 Change-Id: I67efd7fd3b3a550428b16518bb27a3d81c178d28 Reviewed-on: https://go-review.googlesource.com/c/go/+/181840 Run-TryBot: Ian Lance Taylor TryBot-Result: Gobot Gobot Reviewed-by: Bryan C. Mills --- src/cmd/go/alldocs.go | 7 +++++++ src/cmd/go/internal/modload/help.go | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/src/cmd/go/alldocs.go b/src/cmd/go/alldocs.go index d2ce578564969..40cbaa2331e38 100644 --- a/src/cmd/go/alldocs.go +++ b/src/cmd/go/alldocs.go @@ -1806,6 +1806,13 @@ // including go build, go get, go install, go list, go test, go mod graph, // go mod tidy, and go mod why. // +// The expected language version, set by the go directive, determines +// which language features are available when compiling the module. +// Language features available in that version will be available for use. +// Language features removed in earlier versions, or added in later versions, +// will not be available. Note that the language version does not affect +// build tags, which are determined by the Go release being used. +// // // GOPATH environment variable // diff --git a/src/cmd/go/internal/modload/help.go b/src/cmd/go/internal/modload/help.go index 9ce8dfb33b3c9..788544c2c8517 100644 --- a/src/cmd/go/internal/modload/help.go +++ b/src/cmd/go/internal/modload/help.go @@ -464,5 +464,12 @@ Because the module graph defines the meaning of import statements, any commands that load packages also use and therefore update go.mod, including go build, go get, go install, go list, go test, go mod graph, go mod tidy, and go mod why. + +The expected language version, set by the go directive, determines +which language features are available when compiling the module. +Language features available in that version will be available for use. +Language features removed in earlier versions, or added in later versions, +will not be available. Note that the language version does not affect +build tags, which are determined by the Go release being used. `, }