Message169696
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 |
|
Date |
User |
Action |
Args |
2012-09-02 13:42:18 | chris.jerdonek | set | recipients:
+ chris.jerdonek, georg.brandl, ezio.melotti, eric.araujo, asvetlov, docs@python |
2012-09-02 13:42:18 | chris.jerdonek | set | messageid: <1346593338.06.0.717427531595.issue15831@psf.upfronthosting.co.za> |
2012-09-02 13:42:17 | chris.jerdonek | link | issue15831 messages |
2012-09-02 13:42:17 | chris.jerdonek | create | |
|