io: document that i/o is not necessarily safe for parallel access.

Updates #1599.

R=golang-dev, adg, dsymonds
CC=golang-dev
https://golang.org/cl/5704052

diff --git a/src/pkg/io/io.go b/src/pkg/io/io.go
index bbfa6c2b2aadf71a0053bcb3c670bc3a500f5528..3e2321ce713ce3adb3b587a4995f760dff7d4dfd 100644 (file)
--- a/src/pkg/io/io.go
+++ b/src/pkg/io/io.go
@@ -6,6 +6,10 @@
 // Its primary job is to wrap existing implementations of such primitives,
 // such as those in package os, into shared public interfaces that
 // abstract the functionality, plus some other related primitives.
+//
+// Because these interfaces and primitives wrap lower-level operations with
+// various implementations, unless otherwise informed clients should not
+// assume they are safe for parallel execution.
 package io
 
 import (