Does Python help with the no-Unix handicap?

[david_ullrich at my-deja.com]

In article <3dr9a046wy.fsf at amarok.cnri.reston.va.us>,
  akuchlin at mems-exchange.org (Andrew M. Kuchling) wrote:
> 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.

   Um, the thread was about no-UNIX "handicaps". If Python were
supposed to be UNIX-only then referring to man pages would be
fine - the problem is when you're running Python on Windows
and the docs say that the meaning of this parameter is just
like the UNIX function of the same name...

> 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
>
>


Sent via Deja.com http://www.deja.com/
Before you buy.