encoding/binary: document that PutVarint, PutUvarint assume buffer is big enough

[bradfitz]

... don't document behavior when the buf slice is too small.  (code reveals the answer
is that it panics)

It seems like things are elsewhere moving to AppendFoo signatures (norm, strconv). 
Should this too?

It should at least document its behavior, though.

[adg]

Comment 1:

Labels changed: added priority-go1.

[robpike]

Comment 2:

Owner changed to builder@golang.org.

[bradfitz]

Comment 3:

What's the preferred fix? Documentation or going to AppendFoo style, as done elsewhere?

[rsc]

Comment 4:

Let's just write documentation.

[bradfitz]

Comment 6:

This issue was closed by revision 2c2c202.

Status changed to Fixed.