Added "Learning Python" to the books section.

Updated comments on the documentation.

diff --git a/README b/README
index 511a0d9de65984a0303c31a92ad6847d1ed841de..f468d23791bbd350f060254b51ec52cf31b9a20e 100644 (file)
--- a/README
+++ b/README
@@ -44,18 +44,24 @@ Consortium (see http://www.python.org/consortium/).
 How do I learn Python?
 ----------------------
 
-The official tutorial is still a good place to start (in the Doc
-directory as tut/tut.tex; and http://www.python.org/doc/tut/tut.html).
+The official tutorial is still a good place to start; see
+http://www.python.org/doc/ for online and downloadable versions.
 Aaron Watters wrote a second tutorial, that may be more accessible for
 some: http://www.networkcomputing.com/unixworld/tutorial/005/005.html.
 Both tutorials (as well as most other sources) assume that you already
 know how to program -- if you'd like to write "Python for Dummies", I
 know a publisher who would like to talk to you...
 
-There are now also several books on Python.  While these are still
-based on Python 1.3 or 1.4, the information in them is still 99%
-correct.  The first two books, both first published in October 1996
-and both including a CD-ROM, form excellent companions to each other:
+There are now also several books on Python.  The first book is the
+most recent and covers Python 1.5.X.  The other two books, both
+first published in October 1996 and both including a CD-ROM, form
+excellent companions to each other.  Though these two are still based
+on Python 1.3 or 1.4, the information in them is still 99% correct.
+
+       Learning Python
+       by Mark Lutz and David Ascher
+       O'Reilly & Associates
+       ISBN: 1-56592-464-9
 
        Internet Programming with Python
        by Aaron Watters, Guido van Rossum, and James Ahlstrom
@@ -665,26 +671,19 @@ Miscellaneous issues
 Documentation
 -------------
 
-All documentation is provided in the subdirectory Doc in the form of
-LaTeX files.  In order of importance for new users: Tutorial (tut),
-Library Reference (lib), Language Reference (ref), Extending (ext).
+All documentation is provided online in a variety of formats.  In
+order of importance for new users: Tutorial, Library Reference,
+Language Reference, Extending & Embedding, and the Python/C API.
 Especially the Library Reference is of immense value since much of
 Python's power (including the built-in data types and functions!) is
-described here.
-
-To print the documentation from the LaTeX files, chdir into the Doc
-subdirectory, type "make" (let's hope you have LaTeX installed!), and
-send the four resulting PostScript files (tut.ps, lib.ps, ref.ps, and
-ext.ps) to the printer.  See the README file there.  If you don't have
-LaTeX, you can ftp the PostScript files from the ftp archives (see
-below).
-
-All documentation is also available on-line via the Python web site
-(http://www.python.org/, see below).  It can also be downloaded
-separately from the ftp archives (see below) in Emacs INFO, HTML or
-PostScript form -- see the web site or the FAQ
-(http://grail.cnri.reston.va.us/cgi-bin/faqw.py or
-http://www.python.org/doc/FAQ.html) for more info.
+described there.
+
+All documentation is also available online via the Python web site
+(http://www.python.org/, see below).  It is available online for
+occaissional reference, or can be downloaded in many formats for
+faster access.  The documents are available in HTML, PostScript, PDF,
+HTML Help, and LaTeX; the LaTeX version is primarily for documentation
+authors or people with special formatting requirements.
 
 
 Emacs mode
@@ -818,7 +817,6 @@ Most subdirectories have their own README file.  Most files have
 comments.
 
 Demo/           Demonstration scripts, modules and programs
-Doc/            Documentation (LaTeX sources)
 Grammar/        Input for the parser generator
 Include/        Public header files
 Lib/            Python library modules