[Python-Dev] PEP 457: Syntax For Positional-Only Parameters (original) (raw)

Eric Snow ericsnowcurrently at gmail.com
Wed Oct 9 20:27:37 CEST 2013

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() range(, [, ]) 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

More information about the Python-Dev mailing list