random832 added the comment:

I guess the next question is what the intent is. Was there an intent, which was 
not followed through on, to upgrade these methods to support keyword arguments? 
Or is there an intent (here and everywhere) that documentation using keyword 
argument syntax is appropriate to use to document methods that have default 
values but do not in fact support keyword arguments? What does the "/" in the 
help text mean?

According to PEP 0436 (Argument Clinic), the "/" here indicates that the 
preceding parameters are positional-only, despite the apparent use of keyword 
syntax. Should this convention also be used in the documentation?

----------

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

Reply via email to