cmd/go: remove the doc command

[gopherbot]

by jjandroman:

What steps will reproduce the problem?
1.go doc fmt Printf


What is the expected output?
the same as in godoc fmt Printf

What do you see instead?
An error message stating that `can't load package: package Printf: import
"Printf": cannot find package´ and after that, the whole output of fmt
documentation.

Which compiler are you using (5g, 6g, 8g, gccgo)?


Which operating system are you using?
Windows 7 x64

Which version are you using?  (run 'go version')
go1.0.3

Please provide any additional information below.

[dominikh]

Comment 1:

That'd break backwards compatibility though: 
usage: go doc [-n] [-x] [packages]
Doc runs the godoc command on the packages named by the import paths.
There's probably more than one case where that feature is actively being used.

[griesemer]

Comment 2:

We should consider accepting godoc pkg.x (instead of godoc pkg x), and then go doc pkg.x
might work as well.

[minux]

Comment 3:

agree. simple copy and paste will result in that kind of command line.

[rsc]

Comment 4:

'go doc', like all the other go commands, only accepts package lists (or a
set of files).
it has limited utility. it might be better to delete the 'go doc' command.
russ

[rsc]

Comment 5:

[The time for maybe has passed.]

Labels changed: removed go1.1maybe.

[adg]

Comment 6:

Labels changed: added godoc.

[adg]

Comment 7:

I always thought "go doc" was pretty useless (at least I never use it). I'd be in favor
of removing it.

Labels changed: added priority-later, removed priority-triage.

Status changed to Accepted.

[rsc]

Comment 8:

Labels changed: added go1.2.

[robpike]

Comment 9:

Owner changed to @robpike.

Status changed to Started.

[robpike]

Comment 10:

This issue was closed by revision 71eae5a.

Status changed to Fixed.