cmd/doc: Go 1.5 "go doc" and const block

[pierrre]

In Go 1.5, the new go doc command only shows the first exported constant of a "const" block.

Running go doc on

const (
    Foo = "foo"
    Bar = "bar"
)

const (
    Baz = "baz"
    Buz = "buz"
)

Prints:

package godoc // import "_test/godoc"

const Foo = "foo" ...
const Baz = "baz" ...

In know go help doc says:

Doc prints the documentation comments associated with the item identified by its
arguments (a package, const, func, type, var, or method) followed by a one-line
summary of each of the first-level items "under" that item (package-level declarations
for a package, methods for a type, etc.).

but it's misleading.

[dsnet]

This may be personal preference, but I personally like the fact that the tool doesn't dump a huge list of constants.

[robpike]

Working as intended.