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.

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

cmd/go: no go test -h documentation for test caching 1.10 #23971

Closed
jeanbza opened this issue Feb 21, 2018 · 4 comments
Closed

cmd/go: no go test -h documentation for test caching 1.10 #23971

jeanbza opened this issue Feb 21, 2018 · 4 comments
Labels
Documentation FrozenDueToAge

Comments

@jeanbza
Copy link
Member

jeanbza commented Feb 21, 2018

Please answer these questions before submitting your issue. Thanks!

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

go version go1.10 darwin/amd64

Does this issue reproduce with the latest release?

Yes

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

osx

What did you do?

go test -h

What did you expect to see?

Documentation for disabling test cachine.

What did you see instead?

Nothing about test caching.
@gopherbot
Copy link

Change https://golang.org/cl/95582 mentions this issue: go/test: briefly document test caching

@jeanbza
Copy link
Member Author

jeanbza commented Feb 21, 2018

Submitted a CL for this: https://go-review.googlesource.com/c/go/+/95582

My first one, sorry if I messed up!

@ianlancetaylor ianlancetaylor changed the title No go test -h documentation for test caching 1.10 cmd/go: no go test -h documentation for test caching 1.10 Feb 21, 2018
@ianlancetaylor
Copy link
Contributor

Test caching is documented in the go help test output. I can't how important it is to also documented it in the go test -h output.

@jeanbza
Copy link
Member Author

jeanbza commented Feb 21, 2018

I think it's a QOL thing. I reach for -h when I'm looking for a flag I need to pass; adding a brief ctrl+f-able note about caching and -count=1 at the first place to look for flags seems like an easy win for developers.

That said, I'm not at all learned about the intention of the various forms of docs, so I defer to y'alls experience.

@golang golang locked and limited conversation to collaborators Mar 9, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Assignees
No one assigned
Labels
Documentation FrozenDueToAge
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
3 participants
@ianlancetaylor @jeanbza @gopherbot