GNU bug report logs -
#25557
Documentation of format doesn't describe "g" accurately
Previous Next
Full log
View this message in rfc822 format
[Message part 1 (text/plain, inline)]
Your bug report
#25557: Documentation of format doesn't describe "g" accurately
which was filed against the emacs package, has been closed.
The explanation is attached below, along with your original report.
If you require more details, please reply to 25557 <at> debbugs.gnu.org.
--
25557: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=25557
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
> From: Clément Pit--Claudel <clement.pitclaudel <at> live.com>
> Date: Fri, 27 Jan 2017 17:05:28 -0500
>
> There seems to be a few issues in the docstring of `format':
>
> > %g means print a number in exponential notation
> > or decimal-point notation, whichever uses fewer characters.
>
> This seems wrong:
>
> (format "%g" 3.0) ⇒ "3", but
> (format "%f" 3.0) ⇒ "3.000000", and
> (format "%e" 3.0) ⇒ "3.000000e+00", so %g is neither %f nor %e.
Fixed.
> > The # flag means to use an alternate display form [...]
> > for %e, %f, and %g, it causes a decimal point to be included even if
> > the precision is zero.
>
> This seems incomplete:
>
> (format "%#.5g" 3) ⇒ "3.0000", while
> (format "%.5g" 3) ⇒ "3", so # doesn't just cause changes when the precision is 0.
I don't understand what you are trying to say (nor the significance of
the '.' flag in the example). '#' forces %g to leave the trailing
zeros after the decimal, so I added that -- is that what you wanted to
say?
> > For %e, %f, and %g sequences, the number after the "." in the
> > precision specifier says how many decimal places to show
>
> This seems wrong, too:
>
> (format "%.5g" 3.0) ⇒ "3", not "3.00000"
> (format "%.5g" 3.1) ⇒ "3.1", not "3.10000"
Fixed.
> Similar problems seem to exist in the actual documentation.
If you mean the ELisp manual, I fixed that as well.
> On a related note, is there a way to get a shortest representation of a number? Something like %g, but without exponents.
Sorry, I don't understand the question. How can you represent an
arbitrary number without exponents at all, except by %f?
Anyway, thanks; I'm marking this bug done.
[Message part 3 (message/rfc822, inline)]
[Message part 4 (text/plain, inline)]
Hi emacs,
There seems to be a few issues in the docstring of `format':
> %g means print a number in exponential notation
> or decimal-point notation, whichever uses fewer characters.
This seems wrong:
(format "%g" 3.0) ⇒ "3", but
(format "%f" 3.0) ⇒ "3.000000", and
(format "%e" 3.0) ⇒ "3.000000e+00", so %g is neither %f nor %e.
> The # flag means to use an alternate display form [...]
> for %e, %f, and %g, it causes a decimal point to be included even if
> the precision is zero.
This seems incomplete:
(format "%#.5g" 3) ⇒ "3.0000", while
(format "%.5g" 3) ⇒ "3", so # doesn't just cause changes when the precision is 0.
> For %e, %f, and %g sequences, the number after the "." in the
> precision specifier says how many decimal places to show
This seems wrong, too:
(format "%.5g" 3.0) ⇒ "3", not "3.00000"
(format "%.5g" 3.1) ⇒ "3.1", not "3.10000"
Similar problems seem to exist in the actual documentation. On a related note, is there a way to get a shortest representation of a number? Something like %g, but without exponents.
Thanks!
Clément.
[signature.asc (application/pgp-signature, attachment)]
This bug report was last modified 8 years and 171 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.