[docs] [issue9728] Docs point to FAQ Section 3, but FAQs are not numbered
Daniel Stutzbach
report at bugs.python.org
Wed Sep 1 03:49:09 CEST 2010
New submission from Daniel Stutzbach <daniel at stutzbachenterprises.com>:
In Doc/extending/windows.rst, there's the following text:
------------------------------------------------------------------------
If your module creates a new type, you may have trouble with this line::
PyVarObject_HEAD_INIT(&PyType_Type, 0)
Change it to::
PyVarObject_HEAD_INIT(NULL, 0)
and add the following to the module initialization function::
MyObject_Type.ob_type = &PyType_Type;
Refer to section 3 of the `Python FAQ <http://www.python.org/doc/faq>`_ for
details on why you must do this.
------------------------------------------------------------------------
If I assume that Section 3 means, the third link on the FAQ page, I can't find the FAQ that's being alluded to here. There's a comment in Include/pyport.h that I believe to be related:
/* Under Cygwin, auto-import functions to prevent compilation */
/* failures similar to http://python.org/doc/FAQ.html#3.24 */
However, that link no longer goes to a particular question and I can't tell which question it once referred to.
I ran into this because I'm trying to understand the cause of the issue which I suspect is related to Issue #6672.
----------
assignee: docs at python
components: Documentation
messages: 115285
nosy: brian.curtin, docs at python, stutzbach, tim.golden
priority: normal
severity: normal
stage: needs patch
status: open
title: Docs point to FAQ Section 3, but FAQs are not numbered
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue9728>
_______________________________________
More information about the docs
mailing list