[Python-Dev] [development doc updates]

[David Abrahams]

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
>