This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author eric.araujo
Recipients baptiste.carvello, docs@python, eli.bendersky, eric.araujo, eric.smith, eric.snow, ezio.melotti, georg.brandl, petri.lehtinen, terry.reedy
Date 2011-11-15.14:01:01
SpamBayes Score 6.5443753e-09
Marked as misclassified No
Message-id <1321365662.73.0.290122962966.issue13386@psf.upfronthosting.co.za>
In-reply-to
Content
>>> C functions that have optional arguments but don't accept keyword arguments are a bit unusual,
>>> and IIUC in most of the cases that's an implementation detail that could be removed.
>> So would it be worth the effort to identify each such place in the built-ins/stdlib and
>> eventually change them all?  I've seen support for doing so in other tracker issues and think
>> it's a good idea personally.
Me too.  (Can you give the #ids of these other issues?)

> Probably, if this will bring some added value in addition to being easier to document.
I think we should fix C functions to accept kwargs for the sake of Python programmers, not merely to ease documentation (that would just be a nice side-effect :)


> a few interesting cases such as "range([start,] stop[, step])"or "islice(seq, [start,] stop [, step])"
> I'm afraid those last examples cannot be described with valid Python syntax.
Sphinx lets us give multiple signatures.  I’ve just checked that this markup is valid and does not create duplicate index entries

  .. function:: range(stop)
                range(start, stop)
                range(start, stop, step)

:)
History
Date User Action Args
2011-11-15 14:01:02eric.araujosetrecipients: + eric.araujo, georg.brandl, terry.reedy, eric.smith, ezio.melotti, eli.bendersky, docs@python, eric.snow, baptiste.carvello, petri.lehtinen
2011-11-15 14:01:02eric.araujosetmessageid: <1321365662.73.0.290122962966.issue13386@psf.upfronthosting.co.za>
2011-11-15 14:01:02eric.araujolinkissue13386 messages
2011-11-15 14:01:01eric.araujocreate