Issue 10111: Minor problems with PyFileObject documentation (Doc/c-api/file.rst) (original) (raw)

1. I ran into some (small) problems with the documentation added by revision 62195 (see issue 815646 for background).

2. A small patch that addresses two problems with the Python 2.7 documentation should be attached:

• link three occurrences of "GIL" to the GIL entry in the glossary; and
• add some example code to clarify the usage of PyFile_IncUseCount() andPyFile_DecUseCount().

1. That patch also adds a link to the "Thread State and the Global Interpreter Lock" section to the GIL entry in the Documentation index. That is a separate problem. But fixing that minor problem could also be of help to people (like me) that need to better understand the GIL aspects of those two functions.