[Python-checkins] r70438 - python/trunk/Doc/library/functions.rst

[A.M. Kuchling]

On Tue, Mar 17, 2009 at 02:43:11PM -0700, Raymond Hettinger wrote:
> That seems like a good idea for HTML docs but we should probably have a 
> larger discussion on whether the docs
> need to retain their usability in printed form.   The docs
> probably need to be staticly usable and not just accessible
> through a browser or PDF viewer.

IMHO: printing the documentation no longer matters.  I cannot remember
the last time I printed the documentation for an application or
program; I either buy a tutorial book, which is never just a
reprinting of the docs, or I look it up online.  I own reference books
for things like MySQL, but they gather dust; a bookmark for 'MySQL 5.0
docs' is so much easier than flipping around in abook.

Most developers work on network-connected machines.  Even if they're
not network-connected, machines have large enough hard-drives so that
everyone can keep the formatted HTML docs around.

--amk