[issue16776] Document PyCFunction_New and PyCFunction_NewEx functions

[Guido van Rossum]

Guido van Rossum  added the comment:

I'm sprinting with Roger. Based on Petr's comment I am closing this issue -- if 
we should not draw attention to this function let's not document it.

@svetlov if you still think it should be documented, can you suggest where the 
documentation should go? The best place we could come up with is in the file 
where Andrew put it.

--
nosy: +gvanrossum
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16776] Document PyCFunction_New and PyCFunction_NewEx functions

[Roger Hurwitz]

Roger Hurwitz  added the comment:

I am at PyCascades at the CPython sprint, and I will work on this issue to the 
best of my ability.

--
nosy: +rogerhurwitz

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16776] Document PyCFunction_New and PyCFunction_NewEx functions

[Petr Viktorin]

Petr Viktorin  added the comment:

IMO, PyCFunction* should be a CPython-specific implementation detail: alternate 
implementations of the C-API don't need to support them, and extension authors 
should be fine without using them. (And if not, more efforts like PEP 590 
Vectorcall should make it so.)

The functions are public in the sense that they don't have underscored names, 
but I wouldn't rush to make them documented.

--
nosy: +petr.viktorin

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16776] Document PyCFunction_New and PyCFunction_NewEx functions

[A.M. Kuchling]

Changes by A.M. Kuchling a...@amk.ca:


--
nosy:  -akuchling

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16776
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16776] Document PyCFunction_New and PyCFunction_NewEx functions

[Martin Panter]

Martin Panter added the comment:

I’m far from an expert on the C API, but I was looking for a way to inspect a 
“builtin_function_or_method” a.k.a. PyCFunction_Type a.k.a. 
types.BuiltinMethodType, and ended up looking at the “Instance Method Objects” 
section. So maybe your functions should go near there, or perhaps the nearby 
“Function Objects” section.

--
nosy: +vadmium

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16776
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16776] Document PyCFunction_New and PyCFunction_NewEx functions

[STINNER Victor]

Changes by STINNER Victor victor.stin...@gmail.com:


--
nosy: +haypo

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16776
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16776] Document PyCFunction_New and PyCFunction_NewEx functions

[A.M. Kuchling]

A.M. Kuchling added the comment:

Here's a patch that contains text for a description of these two functions.  
However, I can't figure out what section they would belong in.  They don't 
really belong in http://docs.python.org/3.4/c-api/structures.html, which is for 
the C structures.

Also note that PyCFunctionObject isn't described anywhere.  Should it be?

--
nosy: +akuchling

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16776
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16776] Document PyCFunction_New and PyCFunction_NewEx functions

[A.M. Kuchling]

A.M. Kuchling added the comment:

Mis-clicked and forgot to attach the patch.

--
Added file: http://bugs.python.org/file32578/16776.txt

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16776
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue16776] Document PyCFunction_New and PyCFunction_NewEx functions

[Andrew Svetlov]

New submission from Andrew Svetlov:

c-api docs has no documentation for those public API functions.

--
assignee: docs@python
components: Documentation
keywords: easy
messages: 178115
nosy: asvetlov, docs@python
priority: normal
severity: normal
status: open
title: Document PyCFunction_New and PyCFunction_NewEx functions
type: enhancement
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16776
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com