Python Doc Problem Example: os.path.split

[George Sakkis]

Another epileptic seizure on the keyboard. Apart from clue deficit
disorder, this guy seems to suffer from some serious anger management
problems...*plonk*


"Xah Lee" <xah at xahlee.org> wrote:
> 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,filename), 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 == dirname and
> filename is empty.
> · If the "last" slash is repeated, they are treated as 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_dir/t2/xlali_skami_cukta.html
> 
>  Xah
>  xah at xahlee.org
> ? http://xahlee.org/
>