Message 61950 - Python tracker

➜

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.

Author	rhettinger
Recipients	jyasskin, rhettinger
Date	2008-02-01.06:36:37
SpamBayes Score	0.034227364
Marked as misclassified	No
Message-id	<1201847798.94.0.549018546114.issue1965@psf.upfronthosting.co.za>
In-reply-to

Content
It would be nice in the docstring the definition of "truncate" wasn't assumed. It would be more specific to say that it rounds towards zero or that it is ceil(x) for negatives and floor(x) for positives. Alternatively, state that it returns the integer portion of a Real. The word "truncate" in the docstring is close to being a circular definition -- if you don't know what math.trunc() does, being told it truncates isn't especially informative.

It would be nice in the docstring the definition of "truncate" wasn't 
assumed.  It would be more specific to say that it rounds towards zero 
or that it is ceil(x) for negatives and floor(x) for positives.  
Alternatively, state that it returns the integer portion of a Real.  
The word "truncate" in the docstring is close to being a circular 
definition -- if you don't know what math.trunc() does, being told it 
truncates isn't especially informative.

History
Date	User	Action	Args
2008-02-01 06:36:39	rhettinger	set	spambayes_score: 0.0342274 -> 0.034227364 recipients: + rhettinger, jyasskin
2008-02-01 06:36:38	rhettinger	set	spambayes_score: 0.0342274 -> 0.0342274 messageid: <1201847798.94.0.549018546114.issue1965@psf.upfronthosting.co.za>
2008-02-01 06:36:38	rhettinger	link	issue1965 messages
2008-02-01 06:36:37	rhettinger	create