[Python-Dev] [development doc updates]

Fred L. Drake, Jr. fdrake@acm.org
Fri, 14 Jun 2002 09:53:21 -0400


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