That's great, Fred. You might also want to add the "Return value: New reference." riff to PyObject_RichCompare; I missed that when looking at the existing doc for examples. -Dave From: "Fred L. Drake, Jr." <fdrake@acm.org>
David Abrahams writes:
I wasn't aware of how it would be formatted when I submitted my PyObject_RichCompare patches. I think the different italic "op" usages
are
too similar. Probably \emph should be replaced with something that bold-ifies.
Bold is the wrong thing. I propose:
- change the argument name to "opid" - let the "op" stand-in show in the code font so it contrasts with the o1 and o2 references in the \samp.
Here's what it looks like:
http://www.python.org/dev/doc/devel/api/object.html#l2h-170
If that works for you, let me know and I'll update the 2.2.x docs and commit the changes.
Thanks for your comments!
-Fred
-- Fred L. Drake, Jr. <fdrake at acm.org> PythonLabs at Zope Corporation