aboutsummaryrefslogtreecommitdiff
path: root/src/cmd/go/alldocs.go
diff options
context:
space:
mode:
authorShogo Hida <shogo.hida@gmail.com>2023-05-10 14:41:06 +0000
committerGopher Robot <gobot@golang.org>2023-05-10 15:11:42 +0000
commit93d9035c9e8b129578d3a177fd90eb308e44a597 (patch)
tree2e50dc0c8d48d092d574ad90d1662eb42e50eac2 /src/cmd/go/alldocs.go
parent46847c639b3e5b3df0c4b06fd19d1cc90bc0306e (diff)
downloadgo-93d9035c9e8b129578d3a177fd90eb308e44a597.tar.gz
go-93d9035c9e8b129578d3a177fd90eb308e44a597.zip
cmd/go/internal: update documentation of go test and go generate
Fixes #57050 Change-Id: I46cac667ff78ac171c878f4366f8f01f58f1d27d GitHub-Last-Rev: 697c255ece18cd4772b76d62991474a7da2536d8 GitHub-Pull-Request: golang/go#57814 Reviewed-on: https://go-review.googlesource.com/c/go/+/461683 TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Bryan Mills <bcmills@google.com>
Diffstat (limited to 'src/cmd/go/alldocs.go')
-rw-r--r--src/cmd/go/alldocs.go9
1 files changed, 9 insertions, 0 deletions
diff --git a/src/cmd/go/alldocs.go b/src/cmd/go/alldocs.go
index 4314d771fb..8bcbd3f764 100644
--- a/src/cmd/go/alldocs.go
+++ b/src/cmd/go/alldocs.go
@@ -567,6 +567,11 @@
// generator, containing the Go toolchain and standard library.
// $DOLLAR
// A dollar sign.
+// $PATH
+// The $PATH of the parent process, with $GOROOT/bin
+// placed at the beginning. This causes generators
+// that execute 'go' commands to use the same 'go'
+// as the parent 'go generate' command.
//
// Other than variable substitution and quoted-string evaluation, no
// special processing such as "globbing" is performed on the command
@@ -1703,6 +1708,10 @@
// error. (The go command's standard error is reserved for printing
// errors building the tests.)
//
+// The go command places $GOROOT/bin at the beginning of $PATH
+// in the test's environment, so that tests that execute
+// 'go' commands use the same 'go' as the parent 'go test' command.
+//
// Go test runs in two different modes:
//
// The first, called local directory mode, occurs when go test is