[issue10488] Improve documentation for 'float' built-in.

2010-11-21 Thread Mark Dickinson

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.

2010-11-21 Thread Mark Dickinson

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.

2010-11-21 Thread Mark Dickinson

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.

2010-11-21 Thread Mark Dickinson

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.

2010-11-21 Thread Ezio Melotti

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.

2010-11-21 Thread Mark Dickinson

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.

2010-11-21 Thread Eric Smith

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.

2010-11-21 Thread Mark Dickinson

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.

2010-11-21 Thread Raymond Hettinger

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.

2010-11-21 Thread Mark Dickinson

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