Skip to content

cmd/go: improve documentation in go help packages #14351

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
perillo opened this issue Feb 16, 2016 · 2 comments
Closed

cmd/go: improve documentation in go help packages #14351

perillo opened this issue Feb 16, 2016 · 2 comments
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge NeedsFix The path to resolution is known, but the work has not been done.
Milestone
Go1.8

Comments

@perillo
Copy link
Contributor

perillo commented Feb 16, 2016

From loadPackage documentation:
In addition to ordinary import paths, loadPackage accepts pseudo-paths beginning with cmd/ to denote commands in the Go command directory, as well as paths to those directories..

However this is not documented. go help package only says:
"cmd" expands to the Go repository's commands and their internal libraries..
@ianlancetaylor ianlancetaylor added this to the Go1.7 milestone Feb 16, 2016
@mdempsky
Copy link
Contributor

Aside: This confused me when playing around with gb, where it's typical for end users to use command paths like "cmd/foo". It seems that package go/build is okay with finding "cmd/foo" within GOPATH, but cmd/go rejects "go install cmd/foo" unless it can find cmd/foo within GOROOT.

@mdempsky mdempsky modified the milestones: Go1.8, Go1.7 May 19, 2016
@mdempsky mdempsky added the Documentation Issues describing a change to documentation. label May 19, 2016
@quentinmit quentinmit added the NeedsFix The path to resolution is known, but the work has not been done. label Oct 7, 2016
@gopherbot
Copy link
Contributor

CL https://golang.org/cl/31663 mentions this issue.

@golang golang locked and limited conversation to collaborators Oct 24, 2017
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Assignees
No one assigned
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge NeedsFix The path to resolution is known, but the work has not been done.
Projects
None yet
Milestone
Go1.8
Development

No branches or pull requests
5 participants
@mdempsky @quentinmit @ianlancetaylor @perillo @gopherbot