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 larry
Recipients georg.brandl, larry, ncoghlan, serhiy.storchaka, yselivanov, zach.ware
Date 2014-02-06.14:08:54
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1391695750.05.0.146053236138.issue20530@psf.upfronthosting.co.za>
In-reply-to
Content
Following a new discussion of the format of the text signature, I decided to go with this:
    <name-of-function>(...)\n--\n\n

See here for the discussion:
   https://mail.python.org/pipermail/python-dev/2014-February/132271.html

Patch attached implementing this approach.  Can I get a review?  I want this in before tagging for rc1 on Saturday.

Other changes:

* clinic.py now generates the "/" marker in sigantures to denote
  positional-only parameters.

* clinic.py --make is a lot faster; it prescans the file for any
  clinic block signatures, and if it doesn't see any it skips the file.

* When generating the docstring for a function with optional groups,
  the signature generated is not intended to be machine-readable.
  So it omits the "$", the "/", and the "--" markers.  (See
  Modules/_cursesmodule.c for the one and only example.)
History
Date User Action Args
2014-02-06 14:09:12larrysetrecipients: + larry, georg.brandl, ncoghlan, zach.ware, serhiy.storchaka, yselivanov
2014-02-06 14:09:10larrysetmessageid: <1391695750.05.0.146053236138.issue20530@psf.upfronthosting.co.za>
2014-02-06 14:09:09larrylinkissue20530 messages
2014-02-06 14:09:09larrycreate