Python Doc Problem Example: os.path.split

[Xah Lee]

Python Doc Problem Example

Quote from:
http://docs.python.org/lib/module-os.path.html
----------
split( path)
Split the pathname path into a pair, (head, tail) where tail is the
last pathname component and head is everything leading up to that. The
tail part will never contain a slash; if path ends in a slash, tail
will be empty. If there is no slash in path, head will be empty. If
path is empty, both head and tail are empty. Trailing slashes are
stripped from head unless it is the root (one or more slashes only). In
nearly all cases, join(head, tail) equals path (the only exception
being when there were multiple slashes separating head from tail).
----------

Can anyone tell me what this verbiage is trying to fucking say?

what the fuck is with the head and tail thing?

is the doc writer, trying to write the doc with some austereness, but
is confused about the behavior of split, or confused about expressing
it? Did his pretension fucked him up?

i was working on a program where i needed to split a path into dirname,
corename, and suffix. But this fucking python doc diverted my work and
wasted my time. It normally isn't a problem to find imperfections in
the world except the fucking OpenSourcers fuck with their fucking
moronicity and moronitude and propagate haughtily their fucking lies
and stupidity. Die.

Suggested rewrite:

split(path)
returns a pair (dirname,filena me), where dirname is the part of path
up to the last slash, and filename is the rest of the string after the
last slash.

Exceptional cases are:
• if path is a single slash (or repeated), then path == dirnameand
filename is empty.
• If the “last� slash is repeated, they are treatedas one single
slash.

------------
Fuck the motherfucking liers of OpenSourcing fuckheads.
(Note: my use of OpenSource here does not include people of GNU
community.)

For more about Python Doc problems, see
http://xahlee.org/Periodic_dosage_di...ami_cukta.html

Xah
xa*@xahlee.org
∑ http://xahlee.org/

[Diez B. Roggisch]

I think this is unfair. The use of "slash" is a failing of the current
documentation. If his use is an indication of a nano-tube-narrow
mindset then so would be the use by the actual documentation writers.

You're right - I missed that somehow, as the original docs talk about
components - which made me assume that these are independently defined
from the slash.

But I stand by the nano-tube-narrow mind-set of Xah Lee. Besides his
tourette syndrome he also is simply unwilling to read documentation if
it is not what _he_ expects it to be.

Diez

[Peter Hansen]

Diez B. Roggisch wrote:

I think this is unfair. The use of "slash" is a failing of the current
documentation . If his use is an indication of a nano-tube-narrow
mindset then so would be the use by the actual documentation writers.
You're right - I missed that somehow, as the original docs talk about
components - which made me assume that these are independently defined
from the slash.

That's okay. We hardly lack for examples of his double standard: note
his claim that split() returns a (dirname, filename) pair, which is not
correct in all cases either, making his suggestion no better than the
stuff he criticizes, at best.
But I stand by the nano-tube-narrow mind-set of Xah Lee. Besides his
tourette syndrome he also is simply unwilling to read documentation if
it is not what _he_ expects it to be.

It's interesting to note that c.l.p still manages to give cordial and
helpful replies when his posts are not offensive ... in spite of us all
repeatedly being labelled "fuckers" and worse.

I strongly suspect (and here I manage to get this on-topic, to the shock
of all) that he learned English from something written (apparently) by
Monty Python, and mistakenly thought this was how most people speak in
public (see http://www.sigg3.net/myself/fuck.html for but one copy).

-Peter

[Steve Holden]

Peter Hansen wrote:

Diez B. Roggisch wrote: [...]

But I stand by the nano-tube-narrow mind-set of Xah Lee. Besides his
tourette syndrome he also is simply unwilling to read documentation if
it is not what _he_ expects it to be.

It's interesting to note that c.l.p still manages to give cordial and
helpful replies when his posts are not offensive ... in spite of us all
repeatedly being labelled "fuckers" and worse.

That's the friendly fuckers on c.l.py for you ...
I strongly suspect (and here I manage to get this on-topic, to the shock
of all) that he learned English from something written (apparently) by
Monty Python, and mistakenly thought this was how most people speak in
public (see http://www.sigg3.net/myself/fuck.html for but one copy).

While this surmise does bring us close to being on-topic I fear you are
being far more charitable than is justified here. But I *am* getting a
bit fucking tired of his rather limited style of discourse.

regards
Steve
--
Steve Holden [phone] [phone]
Holden Web LLC www.holdenweb.com
PyCon TX 2006 www.pycon.org