Skip to content
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.

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

cmd/go: go help packages is out of date #57655

Open
rogpeppe opened this issue Jan 6, 2023 · 1 comment · May be fixed by #57917
Open

cmd/go: go help packages is out of date #57655

rogpeppe opened this issue Jan 6, 2023 · 1 comment · May be fixed by #57917
Assignees
Labels
Documentation help wanted modules NeedsFix The path to resolution is known, but the work has not been done.
Milestone

Comments

@rogpeppe
Copy link
Contributor

rogpeppe commented Jan 6, 2023

What version of Go are you using (go version)?

$ go version
go version devel go1.20-119f679a3b Thu Jan 5 19:33:00 2023 +0000 linux/amd64

Does this issue reproduce with the latest release?

Yes

What operating system and processor architecture are you using (go env)?

N/A

What did you do?

go help packages

What did you expect to see?

Documentation explaining how to specify package paths in the usual mode that the go command is used (module mode).

What did you see instead?

Paragraphs like this, which apply only in GOPATH mode
with apparently no explanation of what the behaviour is in module mode:

Otherwise, the import path P denotes the package found in
the directory DIR/src/P for some DIR listed in the GOPATH
environment variable (For more details see: 'go help gopath').

  • "all" expands to all packages found in all the GOPATH
    trees. For example, 'go list all' lists all the packages on the local
    system. When using modules, "all" expands to all packages in
    the main module and their dependencies, including dependencies
    needed by tests of any of those.

An import path is a pattern if it includes one or more "..." wildcards,
each of which can match any string, including the empty string and
strings containing slashes. Such a pattern expands to all package
directories found in the GOPATH trees with names matching the
patterns.

Looks like an update is needed.

@bcmills bcmills added Documentation help wanted NeedsFix The path to resolution is known, but the work has not been done. modules labels Jan 6, 2023
@bcmills bcmills added this to the Backlog milestone Jan 6, 2023
Ja7ad added a commit to GoFarsi/go that referenced this issue Jan 19, 2023
@gopherbot
Copy link

Change https://go.dev/cl/462288 mentions this issue: cmd/go/help: update package long description base on go module

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation help wanted modules NeedsFix The path to resolution is known, but the work has not been done.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants