[issue14129] Corrections for the "extending" doc

Roundup Robot added the comment: New changeset 6c737eb12c3e by Eli Bendersky in branch 'default': Some corrections for the Doc/extending documentation. Closes #14129 http://hg.python.org/cpython/rev/6c737eb12c3e -- nosy: +python-dev resolution: -> fixed stage: patch review -> committed

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: Thanks for the review. I'm going to do the commit now. Feel free to just fix it if any obvious mistakes remain. -- ___ Python tracker ___ _

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: Patch attached -- keywords: +patch stage: -> patch review Added file: http://bugs.python.org/file24663/issue_14129.1.patch ___ Python tracker _

[issue14129] Corrections for the "extending" doc

Éric Araujo added the comment: > "in this case, nothing more than every Python object contains" > There's a grammar error lurking somewhere in there... It could be: “nothing more that what every Python object contains”. Could you post a patch for review? -- __

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: Adding the documentation experts. I plan to apply a fix for these soon. If you guys have any objections, let me know. -- nosy: +eric.araujo, ezio.melotti, georg.brandl ___ Python tracker

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: There are some: " XXX Need to ... " 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. -- _

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: "but in this cased" Typo [this and the past couple of comments refer to the newtypes.html doc] -- ___ Python tracker ___ _

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: Noddy_name in the full code listing (included from noddy2.c) is different from the Noddy_name that is actually explained later -- ___ Python tracker __

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: "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 -- ___ Python tracker __

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: "Let’s expend " Typo -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: 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 -- ___ Python tracker

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: "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. -- nosy: +docs@python _

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: "in this case, nothing more than every Python object contains" There's a grammar error lurking somewhere in there... -- ___ Python tracker ___

[issue14129] Corrections for the "extending" doc

Eli Bendersky added the comment: extending.html has a reference to "Demo/embed/demo.c" which no longer exists in the source distribution -- ___ Python tracker ___ _

[issue14129] Corrections for the "extending" doc

New submission from Eli Bendersky : 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. -- assignee: eli.bendersky components: Documentation keywords: easy messag