[issue19723] Argument Clinic should add markers for humans

[Larry Hastings]

Larry Hastings added the comment:

Antoine just suggested that, if we used this "accumulator" thing, we'd want a convention for where the generated text should go.  I actually have an answer for that: near the end, below the implementations of the module / class methods, but above the methoddef/type structures and the module init function.

My reasoning: when I navigate CPython C files implementing a module or a type, when I know what entry point I want I just search for its name.  When I don't know what I want, I jump to the end, then scroll up until I find the name in the init function or the structures.  So I wouldn't want the code at the very end; that would screw up that navigation mode.

----------

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