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

[M.-A. Lemburg]

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.

-- 
Marc-Andre Lemburg
eGenix.com

Professional Python Services directly from the Source  (#1, Jun 08 2010)
>>> Python/Zope Consulting and Support ...        http://www.egenix.com/
>>> mxODBC.Zope.Database.Adapter ...             http://zope.egenix.com/
>>> mxODBC, mxDateTime, mxTextTools ...        http://python.egenix.com/
________________________________________________________________________
2010-07-19: EuroPython 2010, Birmingham, UK                40 days to go

::: Try our new mxODBC.Connect Python Database Interface for free ! ::::


   eGenix.com Software, Skills and Services GmbH  Pastor-Loeh-Str.48
    D-40764 Langenfeld, Germany. CEO Dipl.-Math. Marc-Andre Lemburg
           Registered at Amtsgericht Duesseldorf: HRB 46611
               http://www.egenix.com/company/contact/