[Python-Dev] PEP 457: Syntax For Positional-Only Parameters

[Eric Snow]

On Wed, Oct 9, 2013 at 11:38 AM, R. David Murray <rdmurray at bitdance.com> wrote:
> It seems to me, then, that the solution for the
> handle-the-ugly-existing-practice-groups issue is to make case (3)
> (pydoc prototype) match the convention that we have arrived at for the
> documentation:  multiple signature lines to represent what Argument Clinic
> represents with the group notation.

+1

>
> We don't currently have a doc solution for 'positional only' arguments.
> How about a variant on the '_' markup idea:
>
>     range(<stop>)
>     range(<start>, <stop>[, <step>])
>
> This takes advantage of the fact that the <> notation is commonly used
> in various kinds of programming documentation to indicate "put your
> specific value here".

+1  I was thinking of exactly this same notation.

-eric