summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorRaymond Hettinger <python@rcn.com>2004-09-30 00:59:08 (GMT)
committerRaymond Hettinger <python@rcn.com>2004-09-30 00:59:08 (GMT)
commitf751fa61950c08424c369d32c42c978c492154bc (patch)
treeda97bad3faaac379246f63a5d6f447149f34b013 /Doc
parentfec0c466ad17cc0dfa115ce3ba17a6011e3391d6 (diff)
downloadcpython-f751fa61950c08424c369d32c42c978c492154bc.zip
cpython-f751fa61950c08424c369d32c42c978c492154bc.tar.gz
cpython-f751fa61950c08424c369d32c42c978c492154bc.tar.bz2
SF bug #1035279: hex() and oct() documentation is incorrect
* Updated docs to reflected signed return values. * Fixed a doubled word typo.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/libfuncs.tex18
1 files changed, 5 insertions, 13 deletions
diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex
index d210510..2099f3f 100644
--- a/Doc/lib/libfuncs.tex
+++ b/Doc/lib/libfuncs.tex
@@ -506,12 +506,8 @@ class C:
\begin{funcdesc}{hex}{x}
Convert an integer number (of any size) to a hexadecimal string.
- The result is a valid Python expression. Note: this always yields
- an unsigned literal. For example, on a 32-bit machine,
- \code{hex(-1)} yields \code{'0xffffffff'}. When evaluated on a
- machine with the same word size, this literal is evaluated as -1; at
- a different word size, it may turn up as a large positive number or
- raise an \exception{OverflowError} exception.
+ The result is a valid Python expression.
+ \versionchanged[Formerly only returned an unsigned literal.]{2.4}
\end{funcdesc}
\begin{funcdesc}{id}{object}
@@ -670,12 +666,8 @@ class C:
\begin{funcdesc}{oct}{x}
Convert an integer number (of any size) to an octal string. The
- result is a valid Python expression. Note: this always yields an
- unsigned literal. For example, on a 32-bit machine, \code{oct(-1)}
- yields \code{'037777777777'}. When evaluated on a machine with the
- same word size, this literal is evaluated as -1; at a different word
- size, it may turn up as a large positive number or raise an
- \exception{OverflowError} exception.
+ result is a valid Python expression.
+ \versionchanged[Formerly only returned an unsigned literal.]{2.4}
\end{funcdesc}
\begin{funcdesc}{open}{filename\optional{, mode\optional{, bufsize}}}
@@ -1111,7 +1103,7 @@ It's a function
Implementations may impose restrictions to achieve this.
The C implementation of Python restricts all arguments to
native C longs ("short" Python integers), and also requires
- that that number of elements fit in a native C long.}
+ that the number of elements fit in a native C long.}
\end{funcdesc}
\begin{funcdesc}{zip}{\optional{seq1, \moreargs}}