[issue10488] Improve documentation for 'float' built-in.
Mark Dickinson dicki...@gmail.com added the comment: Grr. Some unintended cut-and-paste duplication there. -- Added file: http://bugs.python.org/file19740/float_builtin_doc.patch ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10488] Improve documentation for 'float' built-in.
Changes by Mark Dickinson dicki...@gmail.com: Removed file: http://bugs.python.org/file19739/float_builtin_doc.patch ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10488] Improve documentation for 'float' built-in.
New submission from Mark Dickinson dicki...@gmail.com: The docs for 'float' are outdated, and also not entirely written in English. :-) Here's a patch. -- assignee: d...@python components: Documentation files: float_builtin_doc.patch keywords: patch messages: 121910 nosy: d...@python, mark.dickinson priority: normal severity: normal status: open title: Improve documentation for 'float' built-in. versions: Python 3.2 Added file: http://bugs.python.org/file19739/float_builtin_doc.patch ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10488] Improve documentation for 'float' built-in.
Mark Dickinson dicki...@gmail.com added the comment: 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. -- nosy: +ezio.melotti ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10488] Improve documentation for 'float' built-in.
Ezio Melotti ezio.melo...@gmail.com added the comment: 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. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10488] Improve documentation for 'float' built-in.
Mark Dickinson dicki...@gmail.com added the comment: 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*. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10488] Improve documentation for 'float' built-in.
Eric Smith e...@trueblade.com added the comment: This is clearly an improvement. Do we want mention __float__? -- nosy: +eric.smith ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10488] Improve documentation for 'float' built-in.
Mark Dickinson dicki...@gmail.com added the comment: Updated patch: - add some examples - mention __float__ - mention that large numeric arguments can result in an OverflowError -- Added file: http://bugs.python.org/file19744/float_builtin_doc_v2.patch ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10488] Improve documentation for 'float' built-in.
Changes by Raymond Hettinger rhettin...@users.sourceforge.net: -- assignee: d...@python - mark.dickinson resolution: - accepted ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue10488] Improve documentation for 'float' built-in.
Mark Dickinson dicki...@gmail.com added the comment: r86648. -- status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10488 ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com