From f751fa61950c08424c369d32c42c978c492154bc Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Thu, 30 Sep 2004 00:59:08 +0000 Subject: SF bug #1035279: hex() and oct() documentation is incorrect * Updated docs to reflected signed return values. * Fixed a doubled word typo. --- Doc/lib/libfuncs.tex | 18 +++++------------- 1 file 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}} -- cgit v0.12