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

fmt: misleading description of %g and %G verbs #9012

Closed
gopherbot opened this issue Oct 29, 2014 · 4 comments
Closed

fmt: misleading description of %g and %G verbs #9012

gopherbot opened this issue Oct 29, 2014 · 4 comments
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge

Comments

@gopherbot
Copy link
Contributor

by alex@zor.io:

http://golang.org/pkg/fmt describes the '%g' verb as 'whichever of %e or %f produces
more compact output' (and similar for '%G').

This is surprising because '%g' may give different output (due to different precision)
to both '%e' and '%f', as is explained a few paragraphs lower in the document.

Suggestion is to clarify the descriptions in the verb table for '%g' and '%G' to make
this clear.
@ianlancetaylor
Copy link
Member

Comment 1:

Labels changed: added repo-main, release-none, documentation.

@gopherbot
Copy link
Contributor Author

Comment 2:

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

@robpike
Copy link
Contributor

robpike commented Oct 29, 2014

Comment 3:

This issue was closed by revision c88ba19.

Status changed to Fixed.

@gopherbot
Copy link
Contributor Author

Comment 4 by alex@zor.io:

Hello,
The change still implies that %g gives you one of (%e,%f), but it is not the case.
Therefore the aspect of this that is misleading is unchanged.
See playground: http://play.golang.org/p/_CVk7__2HL

@gopherbot gopherbot added fixed Documentation Issues describing a change to documentation. labels Oct 29, 2014
@golang golang locked and limited conversation to collaborators Jun 25, 2016
wheatman pushed a commit to wheatman/go-akaros that referenced this issue Jun 25, 2018
@robpike @wheatman
fmt: fix documentation for %g and %G
8fa75fe 
It now echoes what strconv.FormatFloat says.

Fixes golang#9012.

LGTM=rsc
R=golang-codereviews, rsc
CC=golang-codereviews
https://golang.org/cl/169730043
wheatman pushed a commit to wheatman/go-akaros that referenced this issue Jun 26, 2018
@robpike @wheatman
fmt: fix documentation for %g and %G
44356ef 
It now echoes what strconv.FormatFloat says.

Fixes golang#9012.

LGTM=rsc
R=golang-codereviews, rsc
CC=golang-codereviews
https://golang.org/cl/169730043
wheatman pushed a commit to wheatman/go-akaros that referenced this issue Jul 9, 2018
@robpike @wheatman
fmt: fix documentation for %g and %G
ddade76 
It now echoes what strconv.FormatFloat says.

Fixes golang#9012.

LGTM=rsc
R=golang-codereviews, rsc
CC=golang-codereviews
https://golang.org/cl/169730043
wheatman pushed a commit to wheatman/go-akaros that referenced this issue Jul 20, 2018
@robpike @wheatman
fmt: fix documentation for %g and %G
29f669e 
It now echoes what strconv.FormatFloat says.

Fixes golang#9012.

LGTM=rsc
R=golang-codereviews, rsc
CC=golang-codereviews
https://golang.org/cl/169730043
wheatman pushed a commit to wheatman/go-akaros that referenced this issue Jul 30, 2018
@robpike @wheatman
fmt: fix documentation for %g and %G
1683a79 
It now echoes what strconv.FormatFloat says.

Fixes golang#9012.

LGTM=rsc
R=golang-codereviews, rsc
CC=golang-codereviews
https://golang.org/cl/169730043
This issue was closed.
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
Projects
None yet
Milestone
No milestone
Development

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