From 4907c62f99fbfc8608a79a17c20d89f50956d9fc Mon Sep 17 00:00:00 2001
From: Eric Lagergren <eric@ericlagergren.com>
Date: Wed, 28 Mar 2018 18:09:17 -0700
Subject: [PATCH] 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>
---
 src/testing/testing.go | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/testing/testing.go b/src/testing/testing.go
index 7e936f0fca..edee89c999 100644
--- 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:
 //