Does Python help with the no-Unix handicap?
david_ullrich at my-deja.com
david_ullrich at my-deja.com
Wed Jun 14 13:11:53 EDT 2000
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.
More information about the Python-list
mailing list