io: document non-guarantees of io.Closer

R=r, golang-dev
CC=golang-dev
https://golang.org/cl/8575043

diff --git a/src/pkg/io/io.go b/src/pkg/io/io.go
index 23d05e575a92561ad12aba33f114d64d78b98567..f901afe423648ee1201bffb80ef1586688a5dee4 100644 (file)
--- a/src/pkg/io/io.go
+++ b/src/pkg/io/io.go
@@ -70,6 +70,9 @@ type Writer interface {
 }
 
 // Closer is the interface that wraps the basic Close method.
+//
+// The behavior of Close after the first call is undefined.
+// Specific implementations may document their own behavior.
 type Closer interface {
        Close() error
 }