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