Ben Finney wrote: > Grant Edwards <[EMAIL PROTECTED]> writes: > >> I don't really understand what the advantage for splitting up >> documentation into screen-sized chunks is supposed to be -- all the >> web browsers I've ever seen can scroll. > > The issue is the time to download the page. Most of the world does not > have fast internet access. > >> One page per module or chapter sure would make it easier to >> search... > > Fortunately online documentation in multiple HTML pages is indexable > by the major search engines; most of those can search within one > domain, or even within one path prefix of a domain.
The new and improved layout uses fewer pages, but indeed feels less snappy. See for yourself: http://docs.python.org/dev/distutils/setupscript.html http://docs.python.org/dist/setup-script.html Peter -- http://mail.python.org/mailman/listinfo/python-list