cmd/go: update cover flag documentation

Cover flag documentation was not up to date, and the -covermode flag
documentation was missing.

Fixes #60438

Change-Id: I11e769fa2a32d074de7a748aa534afdfe2ca4e78
Reviewed-on: https://go-review.googlesource.com/c/go/+/498415
TryBot-Result: Gopher Robot <gobot@golang.org>
Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Than McIntosh <thanm@google.com>
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
This commit is contained in:
Enrico Candino 2023-05-26 00:52:57 +02:00 committed by Gopher Robot
parent ccc42b0f91
commit 7ad92e95b5
2 changed files with 22 additions and 6 deletions

View File

@ -127,8 +127,17 @@
// Supported only on linux/amd64 or linux/arm64 and only with GCC 7 and higher
// or Clang/LLVM 9 and higher.
// -cover
// enable code coverage instrumentation (requires
// that GOEXPERIMENT=coverageredesign be set).
// enable code coverage instrumentation.
// -covermode set,count,atomic
// set the mode for coverage analysis.
// The default is "set" unless -race is enabled,
// in which case it is "atomic".
// The values:
// set: bool: does this statement run?
// count: int: how many times does this statement run?
// atomic: int: count, but correct in multithreaded tests;
// significantly more expensive.
// Sets -cover.
// -coverpkg pattern1,pattern2,pattern3
// For a build that targets package 'main' (e.g. building a Go
// executable), apply coverage analysis to each package matching
@ -142,7 +151,6 @@
// do not delete it when exiting.
// -x
// print the commands.
//
// -asmflags '[pattern=]arg list'
// arguments to pass on each go tool asm invocation.
// -buildmode mode

View File

@ -84,8 +84,17 @@ and test commands:
Supported only on linux/amd64 or linux/arm64 and only with GCC 7 and higher
or Clang/LLVM 9 and higher.
-cover
enable code coverage instrumentation (requires
that GOEXPERIMENT=coverageredesign be set).
enable code coverage instrumentation.
-covermode set,count,atomic
set the mode for coverage analysis.
The default is "set" unless -race is enabled,
in which case it is "atomic".
The values:
set: bool: does this statement run?
count: int: how many times does this statement run?
atomic: int: count, but correct in multithreaded tests;
significantly more expensive.
Sets -cover.
-coverpkg pattern1,pattern2,pattern3
For a build that targets package 'main' (e.g. building a Go
executable), apply coverage analysis to each package matching
@ -99,7 +108,6 @@ and test commands:
do not delete it when exiting.
-x
print the commands.
-asmflags '[pattern=]arg list'
arguments to pass on each go tool asm invocation.
-buildmode mode