[Python-checkins] r81811 - python/branches/py3k/Doc/c-api/arg.rst

[Antoine Pitrou]

On Tue, 08 Jun 2010 14:44:05 +0200
"M.-A. Lemburg" <mal at egenix.com> wrote:
> Antoine Pitrou wrote:
> > On Mon,  7 Jun 2010 23:20:42 +0200 (CEST)
> > victor.stinner <python-checkins at python.org> wrote:
> >> Issue #8925: fix types of Py_Parse*() and Py_BuildValue() functions
> >>
> >>  * Add links to Python types
> >>  * Replace "string" by bytes or str
> >>  * Replace "long" by "int"
> > 
> > I'm not sure this is a good idea, really. This file describes a part of
> > the C API. Adding links to the Python facing types seems confusing to
> > me. Also, the descriptions themselves still use terms such as "Unicode
> > object" (rather than "str"), which makes things inconsistent and
> > difficult to follow.
> 
> Agreed.
> 
> Perhaps we should start using e.g. PyUnicode, PyBytes,
> PyLong, etc. in the docs to more closely follow the C API rather
> use the type names you see at the Python level.

Yes, I think this would be more useful for the reader.

Regards

Antoine.