Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Georg Brandl
Am 12.10.2013 22:30, schrieb Antoine Pitrou: > On Sat, 12 Oct 2013 22:25:36 +0200 > Georg Brandl wrote: >> >> > ("limited API" is really a bad synonym for "stable ABI" IMO) >> >> >> >> It's not a synonym: to get a stable ABI, you use the limited API. >> > >> > I still don't like that name, becau

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Georg Brandl
Am 12.10.2013 22:09, schrieb Eric V. Smith: > On 10/12/2013 4:04 PM, Georg Brandl wrote: >> Am 12.10.2013 21:56, schrieb Antoine Pitrou: >>> On Sat, 12 Oct 2013 21:19:16 +0200 >>> Georg Brandl wrote: Am 12.10.2013 20:20, schrieb Serhiy Storchaka: > 12.10.13 21:04, Georg Brandl написав(ла)

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Brian Curtin
On Sat, Oct 12, 2013 at 3:17 PM, Serhiy Storchaka wrote: > 12.10.13 22:56, Antoine Pitrou написав(ла): > >> On Sat, 12 Oct 2013 21:19:16 +0200 >> Georg Brandl wrote: >>> >>> Am 12.10.2013 20:20, schrieb Serhiy Storchaka: 12.10.13 21:04, Georg Brandl написав(ла): > > in light of

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Antoine Pitrou
On Sat, 12 Oct 2013 22:25:36 +0200 Georg Brandl wrote: > >> > ("limited API" is really a bad synonym for "stable ABI" IMO) > >> > >> It's not a synonym: to get a stable ABI, you use the limited API. > > > > I still don't like that name, because it doesn't convey any interesting > > information.

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Georg Brandl
Am 12.10.2013 22:16, schrieb Antoine Pitrou: >> >> Well, I may be reading PEP 384 wrongly, but the point is exactly to have a >> >> *stable* API for *non-core* developers to rely upon, so that they can >> >> build >> >> extensions that don't need to be recompiled for every version of Python. >> >

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Eric V. Smith
On 10/12/2013 4:04 PM, Georg Brandl wrote: > Am 12.10.2013 21:56, schrieb Antoine Pitrou: >> On Sat, 12 Oct 2013 21:19:16 +0200 >> Georg Brandl wrote: >>> Am 12.10.2013 20:20, schrieb Serhiy Storchaka: 12.10.13 21:04, Georg Brandl написав(ла): > in light of the recent thread about PEPs no

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Serhiy Storchaka
12.10.13 22:56, Antoine Pitrou написав(ла): On Sat, 12 Oct 2013 21:19:16 +0200 Georg Brandl wrote: Am 12.10.2013 20:20, schrieb Serhiy Storchaka: 12.10.13 21:04, Georg Brandl написав(ла): in light of the recent thread about PEPs not forming part of the docs, I've just pushed a change that all

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Antoine Pitrou
On Sat, 12 Oct 2013 22:04:57 +0200 Georg Brandl wrote: > Am 12.10.2013 21:56, schrieb Antoine Pitrou: > > On Sat, 12 Oct 2013 21:19:16 +0200 > > Georg Brandl wrote: > >> Am 12.10.2013 20:20, schrieb Serhiy Storchaka: > >> > 12.10.13 21:04, Georg Brandl написав(ла): > >> >> in light of the recent

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Georg Brandl
Am 12.10.2013 21:56, schrieb Antoine Pitrou: > On Sat, 12 Oct 2013 21:19:16 +0200 > Georg Brandl wrote: >> Am 12.10.2013 20:20, schrieb Serhiy Storchaka: >> > 12.10.13 21:04, Georg Brandl написав(ла): >> >> in light of the recent thread about PEPs not forming part of the docs, >> >> I've just push

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Serhiy Storchaka
12.10.13 22:19, Georg Brandl написав(ла): Am 12.10.2013 20:20, schrieb Serhiy Storchaka: 12.10.13 21:04, Georg Brandl написав(ла): in light of the recent thread about PEPs not forming part of the docs, I've just pushed a change that allows to document C API elements not part of the limited API

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Antoine Pitrou
On Sat, 12 Oct 2013 21:19:16 +0200 Georg Brandl wrote: > Am 12.10.2013 20:20, schrieb Serhiy Storchaka: > > 12.10.13 21:04, Georg Brandl написав(ла): > >> in light of the recent thread about PEPs not forming part of the docs, > >> I've just pushed a change that allows to document C API elements >

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Georg Brandl
Am 12.10.2013 20:20, schrieb Serhiy Storchaka: > 12.10.13 21:04, Georg Brandl написав(ла): >> in light of the recent thread about PEPs not forming part of the docs, >> I've just pushed a change that allows to document C API elements >> not part of the limited API as such. It is done like this: >>

Re: [Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Serhiy Storchaka
12.10.13 21:04, Georg Brandl написав(ла): in light of the recent thread about PEPs not forming part of the docs, I've just pushed a change that allows to document C API elements not part of the limited API as such. It is done like this: ... c:function:: int _PyTuple_Resize(PyObject **p, Py_ssiz

[Python-Dev] Support for marking limited API elements in C API docs

2013-10-12 Thread Georg Brandl
Hi, in light of the recent thread about PEPs not forming part of the docs, I've just pushed a change that allows to document C API elements not part of the limited API as such. It is done like this: .. c:function:: int _PyTuple_Resize(PyObject **p, Py_ssize_t newsize) :notlimited: I have not