Correct some bitrot; some things have become inaccurate in the tutorial.

<file>.readlines() does not call <file>.readline() internally anymore,
and the sizehint parameter should be mentioned briefly.

Some displays of floating point numbers needed to be updated due to the
change in the repr() of floats (from 1.6).

Both issues were noted by Aahz <aahz@panix.com>.

diff --git a/Doc/tut/tut.tex b/Doc/tut/tut.tex
index 0378ba4af965bbdcd6cd55f942ff617dc436d2cf..6927afee72bfcb6b6e360656ec3e21901632ed6d 100644 (file)
--- a/Doc/tut/tut.tex
+++ b/Doc/tut/tut.tex
@@ -488,11 +488,11 @@ example:
 >>> tax = 17.5 / 100
 >>> price = 3.50
 >>> price * tax
-0.6125
+0.61249999999999993
 >>> price + _
-4.1125
+4.1124999999999998
 >>> round(_, 2)
-4.11
+4.1100000000000003
 \end{verbatim}
 
 This variable should be treated as read-only by the user.  Don't
@@ -2780,8 +2780,12 @@ string containing only a single newline.
 ''
 \end{verbatim}
 
-\code{f.readlines()} uses \code{f.readline()} repeatedly, and returns
-a list containing all the lines of data in the file.
+\code{f.readlines()} returns a list containing all the lines of data
+in the file.  If given an optional parameter \var{sizehint}, it reads
+that many bytes from the file and enough more to complete a line, and
+returns the lines from that.  This is often used to allow efficient
+reading of a large file by lines, but without having to load the
+entire file in memory.  Only complete lines will be returned.
 
 \begin{verbatim}
 >>> f.readlines()