➜
This issue tracker has been migrated to GitHub,
and is currently read-only.
For more information,
see the GitHub FAQs in the Python's Developer Guide.
Created on 2010-11-21 12:25 by mark.dickinson, last changed 2022-04-11 14:57 by admin. This issue is now closed.
| Files | ||||
|---|---|---|---|---|
| File name | Uploaded | Description | Edit | |
| float_builtin_doc.patch | mark.dickinson, 2010-11-21 12:29 | |||
| float_builtin_doc_v2.patch | mark.dickinson, 2010-11-21 13:29 | |||
| Messages (8) | |||
|---|---|---|---|
| msg121910 - (view) | Author: Mark Dickinson (mark.dickinson) *  |
Date: 2010-11-21 12:25 | |
The docs for 'float' are outdated, and also not entirely written in English. :-) Here's a patch. |
|||
| msg121911 - (view) | Author: Mark Dickinson (mark.dickinson) * |
Date: 2010-11-21 12:29 | |
Grr. Some unintended cut-and-paste duplication there. |
|||
| msg121915 - (view) | Author: Eric V. Smith (eric.smith) * |
Date: 2010-11-21 12:44 | |
This is clearly an improvement. Do we want mention __float__? |
|||
| msg121916 - (view) | Author: Mark Dickinson (mark.dickinson) * |
Date: 2010-11-21 12:47 | |
Ah yes; good point about __float__. I'll revise. Ezio Melotti also suggested (on #python-dev) that it would be useful to have some examples here. |
|||
| msg121917 - (view) | Author: Ezio Melotti (ezio.melotti) * |
Date: 2010-11-21 12:48 | |
I would prefer to keep the doc for float() simple, including what it accepts (numbers and strings) and a few examples like ``'1.2'``, ``'.5'``, ``' +3 '``, ``'inf'``, ``'NaN'``. Even if the other information is still valuable, I'm not sure this is the best place where to include it, and I think it might be confusing for unexperienced users. |
|||
| msg121919 - (view) | Author: Mark Dickinson (mark.dickinson) * |
Date: 2010-11-21 12:50 | |
Ezio: can you suggest a better place for a specification of what float accepts? I think it's necessary (especially for people working on alternative implementations) to have the information *somewhere*. |
|||
| msg121923 - (view) | Author: Mark Dickinson (mark.dickinson) * |
Date: 2010-11-21 13:29 | |
Updated patch: - add some examples - mention __float__ - mention that large numeric arguments can result in an OverflowError |
|||
| msg121993 - (view) | Author: Mark Dickinson (mark.dickinson) * |
Date: 2010-11-21 21:10 | |
r86648. |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022-04-11 14:57:09 | admin | set | github: 54697 |
| 2010-11-21 21:10:58 | mark.dickinson | set | status: open -> closed messages: + msg121993 |
| 2010-11-21 21:00:14 | rhettinger | set | assignee: docs@python -> mark.dickinson resolution: accepted |
| 2010-11-21 13:29:35 | mark.dickinson | set | files:
+ float_builtin_doc_v2.patch messages: + msg121923 |
| 2010-11-21 12:50:21 | mark.dickinson | set | messages: + msg121919 |
| 2010-11-21 12:48:22 | ezio.melotti | set | messages: + msg121917 |
| 2010-11-21 12:47:55 | mark.dickinson | set | nosy:
+ ezio.melotti messages: + msg121916 |
| 2010-11-21 12:44:28 | eric.smith | set | nosy:
+ eric.smith messages: + msg121915 |
| 2010-11-21 12:29:52 | mark.dickinson | set | files: - float_builtin_doc.patch |
| 2010-11-21 12:29:45 | mark.dickinson | set | files:
+ float_builtin_doc.patch messages: + msg121911 |
| 2010-11-21 12:25:43 | mark.dickinson | create | |