cmd/go: remove the doc command #4849

gopherbot opened this Issue Feb 19, 2013 · 10 comments


None yet
7 participants

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

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')

Please provide any additional information below.

dominikh commented Feb 20, 2013

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 commented Feb 20, 2013

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 commented Feb 20, 2013

Comment 3:

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

rsc commented Feb 20, 2013

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.

rsc commented Mar 12, 2013

Comment 5:

[The time for maybe has passed.]

Labels changed: removed go1.1maybe.


adg commented Mar 18, 2013

Comment 6:

Labels changed: added godoc.


adg commented Mar 22, 2013

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 commented Jul 30, 2013

Comment 8:

Labels changed: added go1.2.


robpike commented Aug 15, 2013

Comment 9:

Owner changed to @robpike.

Status changed to Started.


robpike commented Aug 16, 2013

Comment 10:

This issue was closed by revision 71eae5a.

Status changed to Fixed.

@rsc rsc added this to the Go1.2 milestone Apr 14, 2015

@rsc rsc removed the go1.2 label Apr 14, 2015

@gopherbot gopherbot locked and limited conversation to collaborators Jun 24, 2016

This issue was closed.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.