[Python-bugs-list] [ python-Bugs-440037 ] C API descriptions not complete/consiste

[noreply@sourceforge.net]

Bugs item #440037, was opened at 2001-07-10 06:26
You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=440037&group_id=5470

Category: Documentation
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Nobody/Anonymous (nobody)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: C API descriptions not complete/consiste

Initial Comment:
Hello,

I have been writing a code generator to call functions
in a Python script from C. The code seems to be working
fine.
In the process, I found some things in the C API manual
that can be improved:

- I would expect 7.4 (numeric objects) before 7.2
(sequence objects)
- PyList_SetItem() does not specify return value
(probably the same as PyTuple_SetItem() "It returns 0
on success.")
- PyList_SET_ITEM() returns a borrowed reference
without specifying to what it refers.
- PyDict_SetItem() doesnot use 'p' in the description
(same for PyDict_SetItemString())
- Return value of both functions is also not specified.
- In PyLong_AsLong(), a stray 'OverflowError' is at the
end of the description.
- Also at PyLong_AsUnsignedLong() (next entry)

What I found lacking in the embedding and extending
manual is the importing of modules, and finding a
function with a specific name from C.  Is this
something that should be included in the EE manual ?
(I'd be willing to give it some thought)

Also, I found 2 'problems' in the interface at code
level. I will add this seperately to the bug report
data base.

Albert (a.t.hofkamp@tue.nl)


----------------------------------------------------------------------

You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=440037&group_id=5470