Document file.next(). Mark xreadlines obsolete (both method and
module). (One thing remains to be done: the gzip class has an
xreadline method; this ought to be replaced by an iterator as well.)
diff --git a/Doc/lib/libxreadlines.tex b/Doc/lib/libxreadlines.tex
index dda56e7..f2fbe24 100644
--- a/Doc/lib/libxreadlines.tex
+++ b/Doc/lib/libxreadlines.tex
@@ -6,6 +6,7 @@
\versionadded{2.1}
+\deprecated{2.3}{Use \code{for line in file} instead.}
This module defines a new object type which can efficiently iterate
over the lines of a file. An xreadlines object is a sequence type