[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