[Python-3000-checkins] r59220 - in python/branches/py3k/Doc: library/_winreg.rst library/array.rst library/bz2.rst library/easydialogs.rst library/exceptions.rst library/functions.rst library/marshal.rst library/pickle.rst library/repr.rst library/stdtypes.rst library/struct.rst reference/datamodel.rst reference/lexical_analysis.rst using/cmdline.rst
georg.brandl
python-3000-checkins at python.org
Thu Nov 29 18:24:34 CET 2007
Author: georg.brandl
Date: Thu Nov 29 18:24:34 2007
New Revision: 59220
Modified:
python/branches/py3k/Doc/library/_winreg.rst
python/branches/py3k/Doc/library/array.rst
python/branches/py3k/Doc/library/bz2.rst
python/branches/py3k/Doc/library/easydialogs.rst
python/branches/py3k/Doc/library/exceptions.rst
python/branches/py3k/Doc/library/functions.rst
python/branches/py3k/Doc/library/marshal.rst
python/branches/py3k/Doc/library/pickle.rst
python/branches/py3k/Doc/library/repr.rst
python/branches/py3k/Doc/library/stdtypes.rst
python/branches/py3k/Doc/library/struct.rst
python/branches/py3k/Doc/reference/datamodel.rst
python/branches/py3k/Doc/reference/lexical_analysis.rst
python/branches/py3k/Doc/using/cmdline.rst
Log:
Remove mentions of "long integer" in the docs.
Credits to HappySmileMan from GHOP.
Modified: python/branches/py3k/Doc/library/_winreg.rst
==============================================================================
--- python/branches/py3k/Doc/library/_winreg.rst (original)
+++ python/branches/py3k/Doc/library/_winreg.rst Thu Nov 29 18:24:34 2007
@@ -219,7 +219,7 @@
| ``1`` | An integer giving the number of values this |
| | key has. |
+-------+---------------------------------------------+
- | ``2`` | A long integer giving when the key was last |
+ | ``2`` | An integer giving when the key was last |
| | modified (if available) as 100's of |
| | nanoseconds since Jan 1, 1600. |
+-------+---------------------------------------------+
Modified: python/branches/py3k/Doc/library/array.rst
==============================================================================
--- python/branches/py3k/Doc/library/array.rst (original)
+++ python/branches/py3k/Doc/library/array.rst Thu Nov 29 18:24:34 2007
@@ -45,10 +45,7 @@
The actual representation of values is determined by the machine architecture
(strictly speaking, by the C implementation). The actual size can be accessed
-through the :attr:`itemsize` attribute. The values stored for ``'L'`` and
-``'I'`` items will be represented as Python long integers when retrieved,
-because Python's plain integer type cannot represent the full range of C's
-unsigned (long) integers.
+through the :attr:`itemsize` attribute.
The module defines the following type:
Modified: python/branches/py3k/Doc/library/bz2.rst
==============================================================================
--- python/branches/py3k/Doc/library/bz2.rst (original)
+++ python/branches/py3k/Doc/library/bz2.rst Thu Nov 29 18:24:34 2007
@@ -99,7 +99,7 @@
.. method:: BZ2File.tell()
- Return the current file position, an integer (may be a long integer).
+ Return the current file position, an integer.
.. method:: BZ2File.write(data)
Modified: python/branches/py3k/Doc/library/easydialogs.rst
==============================================================================
--- python/branches/py3k/Doc/library/easydialogs.rst (original)
+++ python/branches/py3k/Doc/library/easydialogs.rst Thu Nov 29 18:24:34 2007
@@ -160,14 +160,14 @@
.. attribute:: ProgressBar.curval
- The current value (of type integer or long integer) of the progress bar. The
+ The current value (of type integer) of the progress bar. The
normal access methods coerce :attr:`curval` between ``0`` and :attr:`maxval`.
This attribute should not be altered directly.
.. attribute:: ProgressBar.maxval
- The maximum value (of type integer or long integer) of the progress bar; the
+ The maximum value (of type integer) of the progress bar; the
progress bar (thermometer style) is full when :attr:`curval` equals
:attr:`maxval`. If :attr:`maxval` is ``0``, the bar will be indeterminate
(barber-pole). This attribute should not be altered directly.
Modified: python/branches/py3k/Doc/library/exceptions.rst
==============================================================================
--- python/branches/py3k/Doc/library/exceptions.rst (original)
+++ python/branches/py3k/Doc/library/exceptions.rst Thu Nov 29 18:24:34 2007
@@ -217,7 +217,7 @@
.. exception:: OverflowError
Raised when the result of an arithmetic operation is too large to be
- represented. This cannot occur for long integers (which would rather raise
+ represented. This cannot occur for integers (which would rather raise
:exc:`MemoryError` than give up). Because of the lack of standardization of
floating point exception handling in C, most floating point operations also
aren't checked.
Modified: python/branches/py3k/Doc/library/functions.rst
==============================================================================
--- python/branches/py3k/Doc/library/functions.rst (original)
+++ python/branches/py3k/Doc/library/functions.rst Thu Nov 29 18:24:34 2007
@@ -65,7 +65,7 @@
.. function:: abs(x)
- Return the absolute value of a number. The argument may be a plain or long
+ Return the absolute value of a number. The argument may be an
integer or a floating point number. If the argument is a complex number, its
magnitude is returned.
@@ -320,8 +320,8 @@
Take two (non complex) numbers as arguments and return a pair of numbers
consisting of their quotient and remainder when using long division. With mixed
- operand types, the rules for binary arithmetic operators apply. For plain and
- long integers, the result is the same as ``(a // b, a % b)``. For floating point
+ operand types, the rules for binary arithmetic operators apply. For integers,
+ the result is the same as ``(a // b, a % b)``. For floating point
numbers the result is ``(q, a % b)``, where *q* is usually ``math.floor(a / b)``
but may be 1 less than that. In any case ``q * b + a % b`` is very close to
*a*, if ``a % b`` is non-zero it has the same sign as *b*, and ``0 <= abs(a % b)
@@ -435,7 +435,7 @@
Convert a string or a number to floating point. If the argument is a string, it
must contain a possibly signed decimal or floating point number, possibly
- embedded in whitespace. Otherwise, the argument may be a plain or long integer
+ embedded in whitespace. Otherwise, the argument may be an integer
or a floating point number, and a floating point number with the same value
(within Python's floating point precision) is returned. If no argument is
given, returns ``0.0``.
@@ -530,7 +530,7 @@
.. function:: id(object)
- Return the "identity" of an object. This is an integer (or long integer) which
+ Return the "identity" of an object. This is an integer which
is guaranteed to be unique and constant for this object during its lifetime.
Two objects with non-overlapping lifetimes may have the same :func:`id` value.
(Implementation note: this is the address of the object.)
@@ -783,7 +783,7 @@
form ``pow(x, y)`` is equivalent to using the power operator: ``x**y``.
The arguments must have numeric types. With mixed operand types, the coercion
- rules for binary arithmetic operators apply. For int and long int operands, the
+ rules for binary arithmetic operators apply. For :class:`int` operands, the
result has the same type as the operands (after coercion) unless the second
argument is negative; in that case, all arguments are converted to float and a
float result is delivered. For example, ``10**2`` returns ``100``, but
Modified: python/branches/py3k/Doc/library/marshal.rst
==============================================================================
--- python/branches/py3k/Doc/library/marshal.rst (original)
+++ python/branches/py3k/Doc/library/marshal.rst Thu Nov 29 18:24:34 2007
@@ -37,24 +37,13 @@
Not all Python object types are supported; in general, only objects whose value
is independent from a particular invocation of Python can be written and read by
-this module. The following types are supported: ``None``, integers, long
-integers, floating point numbers, strings, Unicode objects, tuples, lists, sets,
+this module. The following types are supported: ``None``, integers,
+floating point numbers, strings, Unicode objects, tuples, lists, sets,
dictionaries, and code objects, where it should be understood that tuples, lists
and dictionaries are only supported as long as the values contained therein are
themselves supported; and recursive lists and dictionaries should not be written
(they will cause infinite loops).
-.. warning::
-
- On machines where C's ``long int`` type has more than 32 bits (such as the
- DEC Alpha), it is possible to create plain Python integers that are longer
- than 32 bits. If such an integer is marshaled and read back in on a machine
- where C's ``long int`` type has only 32 bits, a Python long integer object
- is returned instead. While of a different type, the numeric value is the
- same. (This behavior is new in Python 2.2. In earlier versions, all but the
- least-significant 32 bits of the value were lost, and a warning message was
- printed.)
-
There are functions that read/write files as well as functions operating on
strings.
Modified: python/branches/py3k/Doc/library/pickle.rst
==============================================================================
--- python/branches/py3k/Doc/library/pickle.rst (original)
+++ python/branches/py3k/Doc/library/pickle.rst Thu Nov 29 18:24:34 2007
@@ -328,7 +328,7 @@
* ``None``, ``True``, and ``False``
-* integers, long integers, floating point numbers, complex numbers
+* integers, floating point numbers, complex numbers
* normal and Unicode strings
Modified: python/branches/py3k/Doc/library/repr.rst
==============================================================================
--- python/branches/py3k/Doc/library/repr.rst (original)
+++ python/branches/py3k/Doc/library/repr.rst Thu Nov 29 18:24:34 2007
@@ -65,7 +65,7 @@
.. attribute:: Repr.maxlong
- Maximum number of characters in the representation for a long integer. Digits
+ Maximum number of characters in the representation for an integer. Digits
are dropped from the middle. The default is ``40``.
Modified: python/branches/py3k/Doc/library/stdtypes.rst
==============================================================================
--- python/branches/py3k/Doc/library/stdtypes.rst (original)
+++ python/branches/py3k/Doc/library/stdtypes.rst Thu Nov 29 18:24:34 2007
@@ -246,7 +246,6 @@
.. index::
single: arithmetic
builtin: int
- builtin: long
builtin: float
builtin: complex
@@ -326,7 +325,7 @@
pair: numeric; conversions
pair: C; language
- Conversion from floating point to (long or plain) integer may round or truncate
+ Conversion from floating point to integer may round or truncate
as in C; see functions :func:`floor` and :func:`ceil` in the :mod:`math` module
for well-defined conversions.
Modified: python/branches/py3k/Doc/library/struct.rst
==============================================================================
--- python/branches/py3k/Doc/library/struct.rst (original)
+++ python/branches/py3k/Doc/library/struct.rst Thu Nov 29 18:24:34 2007
@@ -81,15 +81,15 @@
+--------+-------------------------+--------------------+-------+
| ``i`` | :ctype:`int` | integer | |
+--------+-------------------------+--------------------+-------+
-| ``I`` | :ctype:`unsigned int` | long | |
+| ``I`` | :ctype:`unsigned int` | integer | |
+--------+-------------------------+--------------------+-------+
| ``l`` | :ctype:`long` | integer | |
+--------+-------------------------+--------------------+-------+
-| ``L`` | :ctype:`unsigned long` | long | |
+| ``L`` | :ctype:`unsigned long` | integer | |
+--------+-------------------------+--------------------+-------+
-| ``q`` | :ctype:`long long` | long | \(2) |
+| ``q`` | :ctype:`long long` | integer | \(2) |
+--------+-------------------------+--------------------+-------+
-| ``Q`` | :ctype:`unsigned long | long | \(2) |
+| ``Q`` | :ctype:`unsigned long | integer | \(2) |
| | long` | | |
+--------+-------------------------+--------------------+-------+
| ``f`` | :ctype:`float` | float | |
@@ -139,16 +139,7 @@
used. Note that for :func:`unpack`, the ``'p'`` format character consumes count
bytes, but that the string returned can never contain more than 255 characters.
-For the ``'I'``, ``'L'``, ``'q'`` and ``'Q'`` format characters, the return
-value is a Python long integer.
-For the ``'P'`` format character, the return value is a Python integer or long
-integer, depending on the size needed to hold a pointer when it has been cast to
-an integer type. A *NULL* pointer will always be returned as the Python integer
-``0``. When packing pointer-sized values, Python integer or long integer objects
-may be used. For example, the Alpha and Merced processors use 64-bit pointer
-values, meaning a Python long integer will be used to hold the pointer; other
-platforms use 32-bit pointers and will use a Python integer.
For the ``'t'`` format character, the return value is either :const:`True` or
:const:`False`. When packing, the truth value of the argument object is used.
Modified: python/branches/py3k/Doc/reference/datamodel.rst
==============================================================================
--- python/branches/py3k/Doc/reference/datamodel.rst (original)
+++ python/branches/py3k/Doc/reference/datamodel.rst Thu Nov 29 18:24:34 2007
@@ -177,18 +177,6 @@
object: plain integer
single: OverflowError (built-in exception)
- These represent numbers in the range -2147483648 through 2147483647. (The range
- may be larger on machines with a larger natural word size, but not smaller.)
- When the result of an operation would fall outside this range, the result is
- normally returned as a long integer (in some cases, the exception
- :exc:`OverflowError` is raised instead). For the purpose of shift and mask
- operations, integers are assumed to have a binary, 2's complement notation using
- 32 or more bits, and hiding no bits from the user (i.e., all 4294967296
- different bit patterns correspond to different values).
-
- Long integers
- .. index:: object: long integer
-
These represent numbers in an unlimited range, subject to available (virtual)
memory only. For the purpose of shift and mask operations, a binary
representation is assumed, and negative numbers are represented in a variant of
@@ -210,11 +198,9 @@
.. index:: pair: integer; representation
The rules for integer representation are intended to give the most meaningful
- interpretation of shift and mask operations involving negative integers and the
- least surprises when switching between the plain and long integer domains. Any
+ interpretation of shift and mask operations involving negative integers. Any
operation except left shift, if it yields a result in the plain integer domain
- without causing overflow, will yield the same result in the long integer domain
- or when using mixed operands.
+ without causing overflow, will yield the same result when using mixed operands.
.. % Integers
Modified: python/branches/py3k/Doc/reference/lexical_analysis.rst
==============================================================================
--- python/branches/py3k/Doc/reference/lexical_analysis.rst (original)
+++ python/branches/py3k/Doc/reference/lexical_analysis.rst Thu Nov 29 18:24:34 2007
@@ -567,12 +567,12 @@
Numeric literals
----------------
-.. index:: number, numeric literal, integer literal, plain integer literal
- long integer literal, floating point literal, hexadecimal literal
+.. index:: number, numeric literal, integer literal
+ floating point literal, hexadecimal literal
octal literal, binary literal, decimal literal, imaginary literal, complex literal
-There are four types of numeric literals: plain integers, long integers,
-floating point numbers, and imaginary numbers. There are no complex literals
+There are three types of numeric literals: plain integers, floating point
+numbers, and imaginary numbers. There are no complex literals
(complex numbers can be formed by adding a real number and an imaginary number).
Note that numeric literals do not include a sign; a phrase like ``-1`` is
Modified: python/branches/py3k/Doc/using/cmdline.rst
==============================================================================
--- python/branches/py3k/Doc/using/cmdline.rst (original)
+++ python/branches/py3k/Doc/using/cmdline.rst Thu Nov 29 18:24:34 2007
@@ -171,13 +171,12 @@
Division control. The argument must be one of the following:
- ``old``
- division of int/int and long/long return an int or long (*default*)
``new``
- new division semantics, i.e. division of int/int and long/long returns a
- float
+ new division semantics, i.e. division of int/int returns a float (*default*)
+ ``old``
+ division of int/int returns an int
``warn``
- old division semantics with a warning for int/int and long/long
+ old division semantics with a warning for int/int
``warnall``
old division semantics with a warning for all uses of the division operator
More information about the Python-3000-checkins
mailing list