Commit f757f45e authored by Raymond Hettinger's avatar Raymond Hettinger

SF bug #1035279: hex() and oct() documentation is incorrect

* Updated docs to reflected signed return values.
* Fixed a doubled word typo.
parent 20d6cdd4
......@@ -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}}
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment