Does Python help with the no-Unix handicap?

[Andrew M. Kuchling]

david_ullrich at my-deja.com writes:
>     One of the very few things that bugs me about the Python
> docs... let's say one of the _incredibly_ few things that
> bugs me about the Python docs is where the explanation for
> how something works refers to a UNIX manpage.

The problem is that the semantics of some operations can be quite
complicated, and sometimes they'll vary across different Unix
implementations.  It would be a big job to document all this in
Python, so it's easiest to just point people to the man pages for
their platform.  Perhaps the best compromise would be to give a brief
explanation of the most important points, and refer to the platform's
docs for the fine points of semantics.

-- 
A.M. Kuchling			http://starship.python.net/crew/amk/
On a scale of one to ten I'd give it a tim.
  -- William Tanksley, 13 Sep 1999