diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 48 |
1 files changed, 23 insertions, 25 deletions
@@ -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 |