[docs] Add float linspace recipe to docs (issue 23226)
Andrew Barnert
abarnert at yahoo.com
Tue Jan 13 00:21:18 CET 2015
On Jan 12, 2015, at 15:02, ghost.adh at gmail.com wrote:
Thanks for the quick review. Comments inline.
>
> http://bugs.python.org/review/23226/diff/13605/Doc/library/stdtypes.rst
> File Doc/library/stdtypes.rst (right):
>
> http://bugs.python.org/review/23226/diff/13605/Doc/library/stdtypes.rst#newcode1339
> Doc/library/stdtypes.rst:1339: (e.g., by multiplying instead of
> repeating addition), to avoid
> It's not particularly clear what is responsible for accumulated rounding
> errors: multiplication or repeated addition. Perhaps the whole
> explanation in the brackets could be removed?
It's repeated addition, of course. But you're right, easier to just leave that part out than to try to clarify it.
> http://bugs.python.org/review/23226/diff/13605/Doc/library/stdtypes.rst#newcode1346
> Doc/library/stdtypes.rst:1346: values, and potentially being off by 1
> ulp on the :data:`stop` value)
> sorry, what's `ulp'?
Unit of Least Precision. But again, you're right; anyone who already knows what "ulp" means probably doesn't need this paragraph; "digit" is probably clearer.
>
> http://bugs.python.org/review/23226/diff/13605/Doc/library/stdtypes.rst#newcode1356
> Doc/library/stdtypes.rst:1356: * `linspace recipe
> <http://code.activestate.com/recipes/576694/>`_
> Link leads to OrderedSet recipe
Oops; should be 579000.
> http://bugs.python.org/review/23226/
I'll upload a new patch with these three changes shortly.
More information about the docs
mailing list