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

Georg Brandl g.brandl at gmx.net
Sat Oct 12 23:01:17 CEST 2013


Am 12.10.2013 22:30, schrieb Antoine Pitrou:
> On Sat, 12 Oct 2013 22:25:36 +0200
> Georg Brandl <g.brandl at gmx.net> 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. "Stable ABI" is immediately informative.
>> 
>> It can be changed, but we document the C API, not an ABI.
> 
> This is a rather mistaken statement. The only point of using the
> "limited API" is because it provides the stable ABI. There is *zero*
> other reason of caring about it.

Well, I tried to follow PEP 384 wording.

Georg



More information about the Python-Dev mailing list