Michael Klatt added the comment:
For me, the ambiguity is due to the phrases "exactly one directory separator"
and "the only way to produce a trailing separator".
I would suggest:
"The return value is the concatenation of path and any members of *paths so
that there is a directory separator
SilentGhost added the comment:
your example actually produces '/abc//def/'.
However, I'm not sure where do you get the idea that it should clean up
internal directory separators or do anything at all with the strings in paths.
To me it reads like it's concatenating arguments skipping over the
New submission from Michael Klatt :
The behavior of os.path.join() regarding path separators does not match the
documentation. This affects Python 3.6, and goes back to at least Python 2.7.
>From the documenation:
"The return value is the concatenation of path and any members of *paths with
