summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>1999-05-17 19:35:01 (GMT)
committerFred Drake <fdrake@acm.org>1999-05-17 19:35:01 (GMT)
commit0e6444c709b5b7dfa6a5beea12586a2f9c2a6a33 (patch)
tree70802229d61463acf331f839a3b34c43535faefc
parent33378da964b1759a8e88d2941c5d705b514859f4 (diff)
downloadcpython-0e6444c709b5b7dfa6a5beea12586a2f9c2a6a33.zip
cpython-0e6444c709b5b7dfa6a5beea12586a2f9c2a6a33.tar.gz
cpython-0e6444c709b5b7dfa6a5beea12586a2f9c2a6a33.tar.bz2
Added "Learning Python" to the books section.
Updated comments on the documentation.
-rw-r--r--README48
1 files changed, 23 insertions, 25 deletions
diff --git a/README b/README
index 511a0d9..f468d23 100644
--- 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