On 08/04/2016 11:58 PM, Nick Coghlan wrote:
I occasionally wonder if we should document the "/" notation in
as it can sometimes show up in the text representation of signature

    >>> print(inspect.signature(format))
    (value, format_spec='', /)

I think we probably should.  After all, this same string is used for pydoc:
>>> import os
>>> help(os.execv)
Help on built-in function execv in module posix:

execv(path, argv, /)
    Execute an executable path with arguments, replacing current process.
      Path of executable file.
      Tuple or list of strings.

so it's easily user-visible.

I've always found it  a little strange that the signatures for functions using Py_ArgParseTuple() had this / in them that wasn't Python syntax.  On the other hand, it accurately reflects the fact that these functions have signatures that you can't write in Python.

(And, FWIW, I wasn't the person who added the code that made "/" start showing up in the text representations of signatures.  I was waffling on it, then someone else JFDI, to quote Barry.)