mirror
/
go
mirror of https://github.com/golang/go.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

cmd/go: document unsettable GOTELEMETRY and GOTELEMETRYDIR go env vars 

This change adds documentation to "go help telemetry" and "go help
environment" for the unsettable GOTELEMETRY and GOTELEMETRYDIR go env
variables.

For #68928

Change-Id: I8c139bd8585ffb0c45b9dd722ef6e7a9a33df192
Reviewed-on: https://go-review.googlesource.com/c/go/+/607855
Reviewed-by: Robert Findley <rfindley@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
This commit is contained in:
Michael Matloob 2024-08-22 12:00:10 -04:00
parent 422f4705ca
commit d2879efd02
3 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
src/cmd/go/alldocs.go
View File

@ -1797,6 +1797,11 @@
// To enable both collection and uploading, run “go telemetry on”. // To enable both collection and uploading, run “go telemetry on”.
// To disable both collection and uploading, run "go telemetry off". // To disable both collection and uploading, run "go telemetry off".
// //
// The current telemetry mode is also available as the value of the
// non-settable "GOTELEMETRY" go env variable. The directory in the
// local file system that telemetry data is written to is available
// as the value of the non-settable "GOTELEMETRYDIR" go env variable.
//
// See https://go.dev/doc/telemetry for more information on telemetry. // See https://go.dev/doc/telemetry for more information on telemetry.
// //
// # Test packages // # Test packages
@ -2450,6 +2455,11 @@
// If module-aware mode is enabled, but there is no go.mod, GOMOD will be // If module-aware mode is enabled, but there is no go.mod, GOMOD will be
// os.DevNull ("/dev/null" on Unix-like systems, "NUL" on Windows). // os.DevNull ("/dev/null" on Unix-like systems, "NUL" on Windows).
// If module-aware mode is disabled, GOMOD will be the empty string. // If module-aware mode is disabled, GOMOD will be the empty string.
// GOTELEMETRY
// The current Go telemetry mode ("off", "local", or "on").
// See "go help telemetry" for more information.
// GOTELEMETRYDIR
// The directory Go telemetry data is written is written to.
// GOTOOLDIR // GOTOOLDIR
// The directory where the go tools (compile, cover, doc, etc...) are installed. // The directory where the go tools (compile, cover, doc, etc...) are installed.
// GOVERSION // GOVERSION

5
src/cmd/go/internal/help/helpdoc.go
View File

@ -678,6 +678,11 @@ Additional information available from 'go env' but not read from the environment
If module-aware mode is enabled, but there is no go.mod, GOMOD will be If module-aware mode is enabled, but there is no go.mod, GOMOD will be
os.DevNull ("/dev/null" on Unix-like systems, "NUL" on Windows). os.DevNull ("/dev/null" on Unix-like systems, "NUL" on Windows).
If module-aware mode is disabled, GOMOD will be the empty string. If module-aware mode is disabled, GOMOD will be the empty string.
GOTELEMETRY
The current Go telemetry mode ("off", "local", or "on").
See "go help telemetry" for more information.
GOTELEMETRYDIR
The directory Go telemetry data is written is written to.
GOTOOLDIR GOTOOLDIR
The directory where the go tools (compile, cover, doc, etc...) are installed. The directory where the go tools (compile, cover, doc, etc...) are installed.
GOVERSION GOVERSION

5
src/cmd/go/internal/telemetrycmd/telemetry.go
View File

@ -41,6 +41,11 @@ To disable telemetry uploading, but keep local data collection, run
To enable both collection and uploading, run “go telemetry on”. To enable both collection and uploading, run “go telemetry on”.
To disable both collection and uploading, run "go telemetry off". To disable both collection and uploading, run "go telemetry off".
The current telemetry mode is also available as the value of the
non-settable "GOTELEMETRY" go env variable. The directory in the
local file system that telemetry data is written to is available
as the value of the non-settable "GOTELEMETRYDIR" go env variable.
See https://go.dev/doc/telemetry for more information on telemetry. See https://go.dev/doc/telemetry for more information on telemetry.
`, `,
Run: runTelemetry, Run: runTelemetry,