log: update the documentation to clarify the behavior
log: update the documentation to clarify the behavior

R=rsc, PeterGo
CC=golang-dev
http://codereview.appspot.com/2519043
abustany/go,abustany/go,abustany/go,abustany/go,abustany/go,abustany/go,abustany/go