[issue20326] Argument Clinic should use a non-error-prone syntax to mark text signatures

[Nick Coghlan]

Nick Coghlan added the comment:

That wasn't quite what I meant. "def (a, b, c)" *looks* like Python syntax (aside from the missing function name), but "def (a, b, c, /)" does not. So I consider "def " a misleading prefix.

By contrast, neither of these looks like it is trying to be a valid function header, while still hinting strongly that it is signature related:

"sig: (a, b, c)"
"sig: (a, b, c, /)"

I would also be fine with "sig=" (since humans shouldn't be reading this regardless):

"sig=(a, b, c)"
"sig=(a, b, c, /)"

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue20326>
_______________________________________