Author terry.reedy
Recipients Christian.Iversen, docs@python, eric.araujo, eric.smith, mark.dickinson, terry.reedy
Date 2011-11-26.00:08:47
SpamBayes Score 2.18708e-05
Marked as misclassified No
Message-id <1322266128.44.0.41917762925.issue13433@psf.upfronthosting.co.za>
In-reply-to
Content
I find the doc for g/G less than clear.

1. (main entry) "Uses lowercase exponential format if exponent is less than -4 or not less than precision, decimal format otherwise."

'not less' means 'equal or greater', which to me is clearer. Even better and clearer to me would be "Uses decimal format if -4 <= exponent < precision, exponential format otherwise."


2. (note 4) "The precision determines the number of significant digits before and after the decimal point and defaults to 6."

>>> format(.001, 'g')
'0.001'

I only count 4, not 6.

Whoops, that is sort of documented, but in a really backwards way, by saying what the alternate form is. "The alternate form ... trailing zeroes are not removed as they would otherwise be."

>>> format(.001, '.3g')
'0.001'

Now I count 4, not 3.

3. (several notes) 'The alternate form'? I initially though this meant one of the two forms for g/G but then saw it used for other formats with just one form. It took too much searching to find the entry for '#', which I had never noticed before. Please expand to "The alternate '#' form" or add "(Alternate forms are selected by the '#' flag.)" after "Notes:".

I agree with C.I. that we could give some subtle emphasis that g/G treat precision differently. But the difference is more than just including the minimum 1 char before the decimal point in the precision.

>>> format(.001, 'f')
'0.001000'
History
Date User Action Args
2011-11-26 00:08:48terry.reedysetrecipients: + terry.reedy, mark.dickinson, eric.smith, eric.araujo, docs@python, Christian.Iversen
2011-11-26 00:08:48terry.reedysetmessageid: <1322266128.44.0.41917762925.issue13433@psf.upfronthosting.co.za>
2011-11-26 00:08:47terry.reedylinkissue13433 messages
2011-11-26 00:08:47terry.reedycreate