reflect: documentation tweaks
reflect: documentation tweaks

Fixes issue 2952.

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