]> granicus.if.org Git - python/commitdiff
SF bug #1035279: hex() and oct() documentation is incorrect
authorRaymond Hettinger <python@rcn.com>
Thu, 30 Sep 2004 00:59:08 +0000 (00:59 +0000)
committerRaymond Hettinger <python@rcn.com>
Thu, 30 Sep 2004 00:59:08 +0000 (00:59 +0000)
* Updated docs to reflected signed return values.
* Fixed a doubled word typo.

Doc/lib/libfuncs.tex

index d21051022c8f3046fa3ec964393598dc02da6189..2099f3f52bbf203085c4d2b243e921f4d6fc377b 100644 (file)
@@ -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}}