diff --git a/src/cmd/go/doc.go b/src/cmd/go/doc.go index e7c9346326..2fad261e17 100644 --- 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 b505693635..e6dadd2296 100644 --- 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 b1db16f770..ddf9745a3c 100644 --- 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'.