diff --git a/src/cmd/go/alldocs.go b/src/cmd/go/alldocs.go
index af5671b399..f919699627 100644
--- a/src/cmd/go/alldocs.go
+++ b/src/cmd/go/alldocs.go
@@ -2659,7 +2659,8 @@
 // 	    Do not start new tests after the first test failure.
 //
 // 	-json
-// 	    Make the test results available in JSON.
+// 	    Log verbose output and test results in JSON. This presents the
+// 	    same information as the -v flag in a machine-readable format.
 //
 // 	-list regexp
 // 	    List tests, benchmarks, or examples matching the regular expression.
diff --git a/src/cmd/go/internal/test/test.go b/src/cmd/go/internal/test/test.go
index 560f44e610..2a09ab3db9 100644
--- a/src/cmd/go/internal/test/test.go
+++ b/src/cmd/go/internal/test/test.go
@@ -243,7 +243,8 @@ control the execution of any test:
 	    Do not start new tests after the first test failure.
 
 	-json
-	    Make the test results available in JSON.
+	    Log verbose output and test results in JSON. This presents the
+	    same information as the -v flag in a machine-readable format.
 
 	-list regexp
 	    List tests, benchmarks, or examples matching the regular expression.