Sandro Tosi <sandro.t...@gmail.com> added the comment:

That's interesting: do we have a place where we explain how to read the doc? I 
mean, a place were we can provide example/explain how we write docs, so f.e.:

  str.rsplit([sep[, maxsplit]])  

is a description for a method that could accept 2 optional arguments, none of 
them keyargs or

  str.encode(encoding="utf-8", errors="strict")

is a description for a method that could take 2 optional args, and they are 
also keyargs (yeah, I know it's kinda bad-worded, but just to give the idea).

If you think it's overkill, let's just close this bug (after all, we have all 
the doc written our way ;)).

Cheers,
Sandro

----------
nosy: +sandro.tosi

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue8626>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to