[issue31472] "Emulating callable objects" documentation misleading

New submission from Nathan Marrow:
The documentation for emulating callable objects with __call__ seems to imply only positional arguments are supported. For instance, it says __call__ is "object.__call__(self[, args…])" and describes:
Called when the instance is “called” as a function; if this method is defined, x(arg1, arg2, ...) is a shorthand for x.__call__(arg1, arg2, ...).
When it should be something like (Not sure exactly what the syntax would be here): "object.__call__(self[, args…] [,**kwargs...])"
Called when the instance is “called” as a function; if this method is defined, x(arg1, arg2, ..., arg3=arg3) is a shorthand for x.__call__(arg1, arg2, ..., arg3=arg3).
---------- assignee: docs@python components: Documentation messages: 302185 nosy: docs@python, nmarrow priority: normal severity: normal status: open title: "Emulating callable objects" documentation misleading versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue31472 _______________________________________

Change by Irit Katriel iritkatriel@yahoo.com:
---------- keywords: +easy versions: +Python 3.10, Python 3.8, Python 3.9 -Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue31472 _______________________________________

Change by Kamil Turek kamil.turek@hotmail.com:
---------- nosy: +kamilturek
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue31472 _______________________________________
participants (3)
-
Irit Katriel
-
Kamil Turek
-
Nathan Marrow