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 chris.jerdonek
Recipients asvetlov, chris.jerdonek, docs@python, eric.araujo, ezio.melotti, georg.brandl
Date 2012-09-02.13:42:17
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1346593338.06.0.717427531595.issue15831@psf.upfronthosting.co.za>
In-reply-to
Content
Something to be aware of that may or may not affect the patch I'm preparing:

One reason that Sphinx seems able to render some of the more complicated function signatures is that it has logic to bail and print the parameter list verbatim from the reST file whenever its record-keeping logic becomes internally inconsistent:

except IndexError:
    # if there are too few or too many elements on the stack, just give up
    # and treat the whole argument list as one argument, discarding the
    # already partially populated paramlist node

https://bitbucket.org/birkenfeld/sphinx/src/1f3a2749df39/sphinx/domains/python.py#cl-74

This seems to come into play, for example, when rendering--

sorted(iterable[, key][, reverse])

http://docs.python.org/dev/library/functions.html#sorted
History
Date User Action Args
2012-09-02 13:42:18chris.jerdoneksetrecipients: + chris.jerdonek, georg.brandl, ezio.melotti, eric.araujo, asvetlov, docs@python
2012-09-02 13:42:18chris.jerdoneksetmessageid: <1346593338.06.0.717427531595.issue15831@psf.upfronthosting.co.za>
2012-09-02 13:42:17chris.jerdoneklinkissue15831 messages
2012-09-02 13:42:17chris.jerdonekcreate