Mailing List Archive

Python documentation updated!
The documentation for Python 1.5.2 is now available. The online
version is available at:

http://www.python.org/doc/

Archives of the documentation in HTML, LaTeX, PDF, and PostScript
formats are available at the same location, and may also be downloaded
via FTP from:

ftp://ftp.python.org/pub/python/doc/

If you have any questions or comments on the documentation, please
send email to:

python-docs@python.org

Many modules have been documented (166 total!), including both new
and old modules. There have been some additional refinements of the
"look" of the online version, especially for those of you with CSS
enabled in your Web browsers. There is also more extensive
hyperlinking within the Python Library Reference for your convenience.

A new document, "Documenting Python", is now included. Though still
young, this is a useful reference for documentation contributors. It
includes a great deal of information on the markup used for the Python
documentation, as well as a discussion of where we'll go from here.

Windows users: If you installed Python using the installer rather
than by building from source, you can get the updated documentation by
downloading the HTML archive and unpacking it into the "Doc" directory
of your installation.

Some re-organization of the documentation area on the Web site
should make it easier to locate and download documentation.

Thanks go out to all the individuals who have contributed sections
or sent in comments and bug reports; this release of the documentation
is substantially better thanks to the efforts of the Python community!

Enjoy!


-Fred

--
Fred L. Drake, Jr. <fdrake@acm.org>
Corporation for National Research Initiatives
Python documentation updated! [ In reply to ]
Congratulations with the release of the documentation, Fred!
The new version really looks very slick.

--Guido van Rossum (home page: http://www.python.org/~guido/)
Python documentation updated! [ In reply to ]
Fred L. Drake wrote in message
<14122.3325.631762.383828@weyr.cnri.reston.va.us>...

> The documentation for Python 1.5.2 is now available.

Are there substantial differences between the April 13 and the
April 30 versions? Both of them are subtitled "Release 1.5.2".
(The earlier version came with the installation program which
I downloaded on 25 April.)

--
Angus Rodgers --Expel Norse invaders from my e-mail address--
cynical and drunk and boring someone in some iNTeRnEt caf\'{e}
Python documentation updated! [ In reply to ]
Angus Rodgers writes:
> Are there substantial differences between the April 13 and the
> April 30 versions? Both of them are subtitled "Release 1.5.2".
> (The earlier version came with the installation program which
> I downloaded on 25 April.)

Angus,
Both apply to Python 1.5.2; the date on the documents specifies the
documentation release.
The April 30 release includes sections for a number of additional
modules and many, many minor fixes. There are a number of fixes to
the HTML generation process that affect the April 30 release as well.
The April 30 release also includes the "Macintosh Library Modules"
manual, not included in the Windows installer, and some important
additions to the "Python/C API" and "Documenting Python" manuals. If
downloading is expensive for you and you're happy with the April 13
release, I wouldn't worry about it, but if you want the additional
sections or are *really* picky about the presentation (I am ;), go
ahead and pick up the new release. You can compare the "Module Index"
for your copy and the online version of the "Python Library Reference"
to see what modules have been added to the documentation.


-Fred

--
Fred L. Drake, Jr. <fdrake@acm.org>
Corporation for National Research Initiatives