From: Dan Peterson <dpiddy@gmail.com>
Date: Tue, 12 Apr 2016 00:47:37 +0000 (-0300)
Subject: io: document WriteString calls Write exactly once
X-Git-Tag: go1.7beta1~759
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=c9b66bb355ebbc6a26ee511e996cba4da3e1d644;p=gostls13.git

io: document WriteString calls Write exactly once

Fixes #13849

Change-Id: Idd7f06b547a0179fe15571807a8c48b7c3b78d7c
Reviewed-on: https://go-review.googlesource.com/21852
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
---

diff --git a/src/io/io.go b/src/io/io.go
index 023473c79b..c36ec2afbb 100644
--- a/src/io/io.go
+++ b/src/io/io.go
@@ -291,6 +291,7 @@ type stringWriter interface {
 
 // WriteString writes the contents of the string s to w, which accepts a slice of bytes.
 // If w implements a WriteString method, it is invoked directly.
+// Otherwise, w.Write is called exactly once.
 func WriteString(w Writer, s string) (n int, err error) {
 	if sw, ok := w.(stringWriter); ok {
 		return sw.WriteString(s)