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

testing: unordered examples are underdocumented #18840

Closed
ALTree opened this issue Jan 29, 2017 · 1 comment
Closed

testing: unordered examples are underdocumented #18840

ALTree opened this issue Jan 29, 2017 · 1 comment
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge
Milestone

Comments

@ALTree
Copy link
Member

ALTree commented Jan 29, 2017

Unordered examples (9323de3) are documented in go doc cmd/go:

If the last comment begins with "Unordered output:" then the output is compared to the comment, however the order of the lines is ignored

but not in go doc testing (which is the actual place where people will look for Examples documentation).

$ go doc testing | grep -c Unordered
0

and for the same reason there's nothing on https://golang.org/pkg/testing/#hdr-Examples.

@ALTree ALTree added the Documentation Issues describing a change to documentation. label Jan 29, 2017
@ALTree ALTree added this to the Go1.9Maybe milestone Jan 29, 2017
@gopherbot
Copy link
Contributor

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

@golang golang locked and limited conversation to collaborators Apr 10, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge
Projects
None yet
Development

No branches or pull requests

2 participants