[ python-Bugs-1464658 ] PyList_GetItem() clarification

[SourceForge.net]

Bugs item #1464658, was opened at 2006-04-04 23:38
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1464658&group_id=5470

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: None
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Stefan Seefeld (stefan)
Assigned to: Nobody/Anonymous (nobody)
Summary: PyList_GetItem() clarification

Initial Comment:
The PyList_GetItem function is documented at

http://docs.python.org/api/listObjects.html

as returning "...the object at position pos...".
However, even though in python -1 is a valid index,
this function expects a 'real' index.

1) I believe it would be worthwhile pointing out in
   the API docs that in fact a positive value is
   expected.

2) It would be good to change the function signature
   to expect an unsigned int instead of an int for
   the index.


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

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