cmd/go: document usage of external test packages

Fixes #5144

R=golang-dev, r, dave, adg
CC=golang-dev
https://golang.org/cl/8171044

diff --git a/src/cmd/go/doc.go b/src/cmd/go/doc.go
index dcf6612f1f4e806d6edc5258c97277b1ac04221d..664d51f2579b6526b3a605221d9b470861e86d12 100644 (file)
--- a/src/cmd/go/doc.go
+++ b/src/cmd/go/doc.go
@@ -398,6 +398,9 @@ the file pattern "*_test.go".  These additional files can contain test functions
 benchmark functions, and example functions.  See 'go help testfunc' for more.
 Each listed package causes the execution of a separate test binary.
 
+Additionally, test files that declare a package with the suffix "_test" will be
+compiled and executed separately from the package test binary.
+
 By default, go test needs no arguments.  It compiles and tests the package
 with source in the current directory, including tests, and runs the tests.
 

diff --git a/src/cmd/go/test.go b/src/cmd/go/test.go
index 58ebcc0717d0f392025a3bd9e9cc7378910cd721..babdb18503e17b2fad1c19acc79d68a542ea6b25 100644 (file)
--- a/src/cmd/go/test.go
+++ b/src/cmd/go/test.go
@@ -50,6 +50,9 @@ the file pattern "*_test.go".  These additional files can contain test functions
 benchmark functions, and example functions.  See 'go help testfunc' for more.
 Each listed package causes the execution of a separate test binary.
 
+Additionally, test files that declare a package with the suffix "_test" will be
+compiled and executed separately from the package test binary.
+
 By default, go test needs no arguments.  It compiles and tests the package
 with source in the current directory, including tests, and runs the tests.