[Python-checkins] r67868 - python/branches/release26-maint/Doc/library/stdtypes.rst

[raymond.hettinger]

Author: raymond.hettinger
Date: Sat Dec 20 08:28:32 2008
New Revision: 67868

Log:
Clarify the round-off behavior of int().
Remove incorrect deprecation (int is alive and well).



Modified:
   python/branches/release26-maint/Doc/library/stdtypes.rst

Modified: python/branches/release26-maint/Doc/library/stdtypes.rst
==============================================================================
--- python/branches/release26-maint/Doc/library/stdtypes.rst	(original)
+++ python/branches/release26-maint/Doc/library/stdtypes.rst	Sat Dec 20 08:28:32 2008
@@ -338,15 +338,13 @@
       module: math
       single: floor() (in module math)
       single: ceil() (in module math)
+      single: trunc() (in module math)      
       pair: numeric; conversions
-      pair: C; language
 
-   Conversion from floating point to (long or plain) integer may round or
-   truncate as in C; see functions :func:`math.floor` and :func:`math.ceil` for
-   well-defined conversions.
-
-   .. deprecated:: 2.6
-      Instead, convert floats to long explicitly with :func:`trunc`.
+   Conversion from floats using :func:`int` or :func:`long` truncates toward
+   zero like the related function, :func:`math.trunc`.  Use the function
+   :func:`math.floor` to round downward and :func:`math.ceil` to round
+   upward.
 
 (3)
    See :ref:`built-in-funcs` for a full description.