doc: Mention godoc's handling of example functions.

Fixes issue 4625.

R=iant, adg
CC=golang-dev
https://codereview.appspot.com/7064052

Committer: Ian Lance Taylor <iant@golang.org>