New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Corrections for the "extending" doc #58337
Comments
I'm now carefully reading through the "extending" documentation pages. This issue will record various problems I find on the way, with the intention of fixing them eventually. |
extending.html has a reference to "Demo/embed/demo.c" which no longer exists in the source distribution |
"A PyObject is not a very magnificent object - it just contains the refcount and a pointer to the object’s “type object”." Too chatty and should be replaced by a more pragmatic explanation, or shortened. |
"in this case, nothing more than every Python object contains" There's a grammar error lurking somewhere in there... |
This is not strictly in the extending doc, but linked from it: http://docs.python.org/dev/c-api/type.html#PyType_GenericNew The PyType_GenericNew API function is not documented |
"Let’s expend " Typo |
"The new method calls the tp_alloc slot to allocate memory" tp_alloc needs formatting here, similarly to the way it's done in other places |
"but in this cased" Typo [this and the past couple of comments refer to the newtypes.html doc] |
Noddy_name in the full code listing (included from noddy2.c) is different from the Noddy_name that is actually explained later |
There are some: " Paragraphs scattered across the doc. These have no place in the official documentation. For placeholders, an issue can be created that lists all the things that need to be done. |
Adding the documentation experts. I plan to apply a fix for these soon. If you guys have any objections, let me know. |
It could be: “nothing more that what every Python object contains”. Could you post a patch for review? |
Patch attached |
Thanks for the review. I'm going to do the commit now. Feel free to just fix it if any obvious mistakes remain. |
New changeset 6c737eb12c3e by Eli Bendersky in branch 'default': |
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields:
bugs.python.org fields:
The text was updated successfully, but these errors were encountered: