testing: document -race goroutine limits

-race sets a hard cap of 8,192, which is easily hit while testing.

Fixes #23611

Change-Id: I0f720ec39c82c2194a485d437d6373f4bdc8a9c1
Reviewed-on: https://go-review.googlesource.com/103160
Reviewed-by: Rob Pike <r@golang.org>

diff --git a/src/testing/testing.go b/src/testing/testing.go
index 7e936f0fcaaa3a4865ec8691c1de9607bd39e179..edee89c9992e81d3ee8fec9be17ca06fece117f7 100644 (file)
--- a/src/testing/testing.go
+++ b/src/testing/testing.go
@@ -178,6 +178,9 @@
 //         }
 //     }
 //
+// The race detector kills the program if it exceeds 8192 concurrent goroutines,
+// so use care when running parallel tests with the -race flag set.
+//
 // Run does not return until parallel subtests have completed, providing a way
 // to clean up after a group of parallel tests:
 //