Martin P. Hellwig wrote:
kj wrote:
[excerpt of previously snipped content restored]
I'm sure that I can find a full description of this parameter if
I fire up Google, and search online. In fact, more likely than
not, I'll find far more documentation than I want. But my point
is that a programmer should not need to do this. The full
documentation should be readily accessible directly through a few
keystrokes.
Well to a level I agree with you.
[snip]
have an adversity for looking up resources using a web browser
It may not be an adversity for looking things up using a
web-browser, but rather the need to access documentation offline.
Whether on an airplane or simply away from a wifi/landline
connection, there are plenty of times I'm coding offline (another
reason I'm happy to have DVCS tools).
This thread prompted me to go digging a little further, and all
the online docs are available in downloadable format, but you
have to start by going to the base docs and chasing down the
"downloads" rabbit-hole. Perhaps it would be easier if there
were some sort of back-link from individual pages, referencing
the downloadable format package.
Combined with the downloaded HTML version of the docs (there are
PDFs too if you prefer), using a lightweight browser like
lynx/links/dillo, and optionally adding htdig for local
search/indexing, you can access (and search) the full docs offline.
-tkc
--
http://mail.python.org/mailman/listinfo/python-list
