Rafe H. Kettler added the comment:
I stumbled upon this issue and I feel similarly about the documentation for a
particular module, ftplib. I think that the documentation is a bit too concise
and assumes that the reader in an expert in the protocol when the point of the
module is to abstract
Rafe H. Kettler added the comment:
I think Brian's second solution ("the result is simply path2 when path1 is
empty or path2 is an absolute path?") is a strong one. If that were tacked on
towards the end it would add some clarity to the docs for people who will end
up using t
Rafe H. Kettler added the comment:
Radu, while the comments are not as clear for ntpath, the behavior is the same.
So, the comment you detailed from posixpath could be adapted to Windows by
replacing '/' with 'a separator' or something of that nature.
That said, the
Rafe H. Kettler added the comment:
Thanks Eric, I think you're right. I'll do that.
--
___
Python tracker
<http://bugs.python.org/issue4758>
___
___
New submission from Rafe H. Kettler :
I think that the documentation for ftplib is a bit too concise and assumes that
the reader in an expert in the protocol when the point of the module is to
abstract out such details.
For example, for the error documentation, the exceptions are only
