cmd/go: document flag passing for tests

Fixes #5566.

R=rsc
CC=gobot, golang-dev
https://golang.org/cl/9882043

diff --git a/src/cmd/go/doc.go b/src/cmd/go/doc.go
index e7c9346326df7168db4d9afa07128fe4fc14d5ce..2fad261e1764588f8bd358b4cc04b6cfe7b2c219 100644 (file)
--- a/src/cmd/go/doc.go
+++ b/src/cmd/go/doc.go
@@ -373,6 +373,7 @@ Usage:
        go run [build flags] gofiles... [arguments...]
 
 Run compiles and runs the main package comprising the named Go source files.
+A Go source file is defined to be a file ending in a literal ".go" suffix.
 
 For more about build flags, see 'go help build'.
 
@@ -383,7 +384,7 @@ Test packages
 
 Usage:
 
-       go test [-c] [-i] [build flags] [packages] [flags for test binary]
+       go test [-c] [-i] [build and test flags] [packages] [flags for test binary]
 
 'Go test' automates testing the packages named by the import paths.
 It prints a summary of the test results in the format:
@@ -421,6 +422,11 @@ In addition to the build flags, the flags handled by 'go test' itself are:
 The test binary also accepts flags that control execution of the test; these
 flags are also accessible by 'go test'.  See 'go help testflag' for details.
 
+If the test binary needs any other flags, they should be presented after the
+package names. The go tool treats as a flag the first argument that begins with
+a minus sign that it does not recognize itself; that argument and all subsequent
+arguments are passed as arguments to the test binary.
+
 For more about build flags, see 'go help build'.
 For more about specifying packages, see 'go help packages'.
 

diff --git a/src/cmd/go/run.go b/src/cmd/go/run.go
index b50569363522cc9148bf542563f584e120785848..e6dadd2296e37258fb4e46940caf9984324ae12a 100644 (file)
--- a/src/cmd/go/run.go
+++ b/src/cmd/go/run.go
@@ -16,6 +16,7 @@ var cmdRun = &Command{
        Short:     "compile and run Go program",
        Long: `
 Run compiles and runs the main package comprising the named Go source files.
+A Go source file is defined to be a file ending in a literal ".go" suffix.
 
 For more about build flags, see 'go help build'.
 

diff --git a/src/cmd/go/test.go b/src/cmd/go/test.go
index b1db16f77040059fbad66de8275f7585ec04c4a8..ddf9745a3c4f1b1e50e152dba8d34a08a3f8e4b9 100644 (file)
--- a/src/cmd/go/test.go
+++ b/src/cmd/go/test.go
@@ -32,7 +32,7 @@ func init() {
 
 var cmdTest = &Command{
        CustomFlags: true,
-       UsageLine:   "test [-c] [-i] [build flags] [packages] [flags for test binary]",
+       UsageLine:   "test [-c] [-i] [build and test flags] [packages] [flags for test binary]",
        Short:       "test packages",
        Long: `
 'Go test' automates testing the packages named by the import paths.
@@ -71,6 +71,11 @@ In addition to the build flags, the flags handled by 'go test' itself are:
 The test binary also accepts flags that control execution of the test; these
 flags are also accessible by 'go test'.  See 'go help testflag' for details.
 
+If the test binary needs any other flags, they should be presented after the
+package names. The go tool treats as a flag the first argument that begins with
+a minus sign that it does not recognize itself; that argument and all subsequent
+arguments are passed as arguments to the test binary.
+
 For more about build flags, see 'go help build'.
 For more about specifying packages, see 'go help packages'.