cmd/godoc: document package-level examples

Fixes  issue  5807 .

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

Committer: Andrew Gerrand <adg@golang.org>