commit a58a8d2e97d605f9f115a0e77ba09cd36bb82ba6
author zdjones <zachj1@gmail.com> Thu Jul 16 12:33:25 2020 +0100
committer Daniel Martí <mvdan@mvdan.cc> Fri Aug 28 21:23:32 2020 +0000
tree 82e7ab63684ff24a36eee92043d7872825cc96d9
parent 54e18f1c2a44f9f2664486e8053c4ee40d41fb8a

test: document specifying individual test files as operands

The current command will run this entire set of tests, which takes a
noticeable amount of time. Contributors may wish to run only a subset of
these tests to save time/compute (e.g. when iterating on a CL that
failed tests in that subset). Listing file(s) as operands to the command
will run only those tests.

Change-Id: I1874c43681a594190bc40b61cee0b8d321be73f8
Reviewed-on: https://go-review.googlesource.com/c/go/+/242997
Reviewed-by: Daniel Martí <mvdan@mvdan.cc>

test/README.md

diff --git a/test/README.md b/test/README.md
index 068dc1b..432d36b 100644
--- a/test/README.md
+++ b/test/README.md
@@ -6,6 +6,10 @@
 
     ../bin/go run run.go
 
+To run just tests from specified files in this directory, execute:
+
+    ../bin/go run run.go -- file1.go file2.go ...
+
 Standard library tests should be written as regular Go tests in the appropriate package.
 
 The tool chain and runtime also have regular Go tests in their packages.