[docs] [issue15029] Update Defining New Types chapter according to PEP 253

Mateusz Loskot report at bugs.python.org
Thu Jun 7 19:25:09 CEST 2012


New submission from Mateusz Loskot <mateusz at loskot.net>:

The chapter '2. Defining New Types" in the Python 3.2 documentation [1] does not cover all important elements, especially in the subsection 2.1.4. Subclassing other types.

The accepted PEP 253 [2] provides much more detailed and thorough explanation for Python C API users willing to define and subclass new types, than the official manual.

I'd like to suggest update of the manual with information enclosed in the PEP 253. In fact, the PEP's sections like

* Preparing a type for subtyping
* Creating a subtype of a built-in type in C

could be copied with little editing, IMHO.

The PEP 253 really seems to be a must-read document for Python C API users.

[1] http://docs.python.org/release/3.2.2/extending/newtypes.html
[2] http://www.python.org/dev/peps/pep-0253/

----------
assignee: docs at python
components: Documentation
messages: 162480
nosy: docs at python, mloskot
priority: normal
severity: normal
status: open
title: Update Defining New Types chapter according to PEP 253
type: enhancement
versions: Python 3.2

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue15029>
_______________________________________


More information about the docs mailing list