bytes: document that Buffer values must not be copied

Change-Id: If0821a2af987b78ed8024b40d9ffa68032518b22
Reviewed-on: https://go-review.googlesource.com/12572
Reviewed-by: Robert Griesemer <gri@golang.org>

diff --git a/src/bytes/buffer.go b/src/bytes/buffer.go
index 4db93867d9aa890faed03430b8d9116714e4c9ea..75dab13048badb5bab582dc2044d183b3dc6faf9 100644 (file)
--- a/src/bytes/buffer.go
+++ b/src/bytes/buffer.go
@@ -14,6 +14,7 @@ import (
 
 // A Buffer is a variable-sized buffer of bytes with Read and Write methods.
 // The zero value for Buffer is an empty buffer ready to use.
+// Buffer values must not be copied.
 type Buffer struct {
        buf       []byte            // contents are the bytes buf[off : len(buf)]
        off       int               // read at &buf[off], write at &buf[len(buf)]