On Wed, Oct 9, 2013 at 11:38 AM, R. David Murray <[email protected]> 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 _______________________________________________ Python-Dev mailing list [email protected] https://mail.python.org/mailman/listinfo/python-dev Unsubscribe: https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com