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

unicode: generated comments have redundant information #28954

Closed
emilyselwood opened this issue Nov 26, 2018 · 3 comments
Closed

unicode: generated comments have redundant information #28954

emilyselwood opened this issue Nov 26, 2018 · 3 comments
Labels
FrozenDueToAge NeedsInvestigation Someone must examine and confirm this is a valid issue and not a duplicate of an existing one.
Milestone

Comments

@emilyselwood
Copy link
Contributor

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

$ go version
go version go1.11 linux/amd64

Does this issue reproduce with the latest release?

yes

What did you do?

Looked at the documentation for the Unicode package. The package variables part contains some redundant information in the category descriptions.

https://golang.org/pkg/unicode/#pkg-variables

When I look at the comments there I have to go away and look up what the category descriptions are so I know which category I need. It would be much better to have the category description included in the comments.

@emilyselwood
Copy link
Contributor Author

I've made a fix for this. I'll send along a CL shortly.

@gopherbot
Copy link
Contributor

Change https://golang.org/cl/151297 mentions this issue: unicode: improve generated comments for categories

@andybons andybons added the NeedsInvestigation Someone must examine and confirm this is a valid issue and not a duplicate of an existing one. label Nov 26, 2018
@andybons andybons added this to the Unplanned milestone Nov 26, 2018
@andybons
Copy link
Member

@robpike

@golang golang locked and limited conversation to collaborators Nov 28, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
FrozenDueToAge NeedsInvestigation Someone must examine and confirm this is a valid issue and not a duplicate of an existing one.
Projects
None yet
Development

No branches or pull requests

3 participants