[docs] [issue34273] %f is confusingly associated with fixed point format

Terry J. Reedy report at bugs.python.org
Fri Aug 3 17:21:58 EDT 2018

Terry J. Reedy <tjreedy at udel.edu> added the comment:

The closest anchor is https://docs.python.org/3.8/library/string.html#format-specification-mini-language.

The table title is "The available presentation types for floating point and decimal values are:".

This is slightly confusing to me.  Does this mean instances of 'float' and 'decimal' classes?  or 'floating point numbers (floats and decimals)  and integral numbers, sometimes called decimals since usually written with decimal digits'?

Within the table, 'number' refers to whatever the title refers to. So I think adding '(floating point)' would be confusing and wrong, as it excludes 'decimals' whatever they are.  On the other hand, changing 'Fixed point' to 'Fixed point notation', in parallel with 'Exponential notation', is correct and should be helpful.

nosy: +terry.reedy
stage:  -> needs patch
versions: +Python 2.7, Python 3.6, Python 3.7, Python 3.8

Python tracker <report at bugs.python.org>

More information about the docs mailing list