From: Rob Pike <r@golang.org>
Date: Wed, 29 Feb 2012 02:30:08 +0000 (+1100)
Subject: io: document that i/o is not necessarily safe for parallel access.
X-Git-Tag: weekly.2012-03-04~96
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=ee149d9a6bf1d25ca0697427a5a1cbf014807a6a;p=gostls13.git

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 bbfa6c2b2a..3e2321ce71 100644
--- 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 (