Message 208788 - Python tracker

Right, at the very least we want to handle positional only arguments (since PEP 362 also handles those).

My one concern with using "def " as the prefix is the fact it's not actually Python syntax.

How do you feel about using "sig: " as the prefix? That would still read sensibly even if you somehow got hold of the unaltered C level docstring rather than going through the properties.