[issue14190] Minor C API documentation bugs

2012-03-04 Thread Baruch Sterin
Baruch Sterin pyt...@bsterin.com added the comment: A few additional ones: The prototype in the documentation is incorrect: * PyFile_SetEncoding accepts PyObject*, not PyFileObject* * PyFile_SetEncodingAndErrors accepts PyObject*, not PyFileObject* PyLong_AsSsize_t is also duplicated

[issue14189] Documentation for some C APIs is missing clear specification of the type of reference they return

2012-03-03 Thread Baruch Sterin
New submission from Baruch Sterin pyt...@bsterin.com: In addition to the description text, most C API functions have a one-line, emphasized specification whether they return a new or a borrowed reference. (e.g. 'Return value: New reference.'). The following API functions are missing

[issue14190] Minor C API documentation bugs

2012-03-03 Thread Baruch Sterin
New submission from Baruch Sterin pyt...@bsterin.com: The following functions are documented, but do not exist in the code: * PyCodec_KnownEncoding * PyRun_SimpleFileFlags The following function is documented and exists in the code, but is not exposed through any of the header files