Skip to content

Commit 27eaffc

Browse files
committed
cmd/go: document GO{NO}SUMDB in 'go help environment' and 'go help modules'
GOSUMDB and GONOSUMDB are described in detail by 'go help module-auth'. So, this change mentions the two variables and says to see 'go help module-auth'. This also adds GONOPROXY to 'go help environment'. Fixes #32292 and updates #32056. Change-Id: I2eae0f906a3fbfcb88ad5c8fb4870917d0d7bbcd Reviewed-on: https://go-review.googlesource.com/c/go/+/179219 Reviewed-by: Russ Cox <[email protected]>
1 parent fff4f59 commit 27eaffc

File tree

3 files changed

+30
-6
lines changed

3 files changed

+30
-6
lines changed

src/cmd/go/alldocs.go

+15-3
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

src/cmd/go/internal/help/helpdoc.go

+12-1
Original file line numberDiff line numberDiff line change
@@ -509,7 +509,18 @@ General-purpose environment variables:
509509
GOPATH
510510
For more details see: 'go help gopath'.
511511
GOPROXY
512-
URL of Go module proxy. See 'go help goproxy'.
512+
URL of Go module proxy. See 'go help modules'.
513+
GONOPROXY
514+
Comma-separated list of glob patterns (in the syntax of Go's path.Match)
515+
of module path prefixes that should always be fetched directly, ignoring
516+
the GOPROXY setting. See 'go help modules'.
517+
GOSUMDB
518+
The name of checksum database to use and optionally its public key and
519+
URL. See 'go help module-auth'.
520+
GONOSUMDB
521+
Comma-separated list of glob patterns (in the syntax of Go's path.Match)
522+
of module path prefixes that should not be compared against the checksum
523+
database. See 'go help module-auth'.
513524
GOROOT
514525
The root of the go tree.
515526
GOTMPDIR

src/cmd/go/internal/modload/help.go

+3-2
Original file line numberDiff line numberDiff line change
@@ -365,8 +365,9 @@ for future go command invocations.
365365
No matter the source of the modules, the go command checks downloads against
366366
known checksums, to detect unexpected changes in the content of any specific
367367
module version from one day to the next. This check first consults the current
368-
module's go.sum file but falls back to the Go checksum database.
369-
See 'go help module-auth' for details.
368+
module's go.sum file but falls back to the Go checksum database, controlled by
369+
the GOSUMDB and GONOSUMDB environment variables. See 'go help module-auth'
370+
for details.
370371
371372
See 'go help goproxy' for details about the proxy protocol and also
372373
the format of the cached downloaded packages.

0 commit comments

Comments
 (0)