[Python-Dev] Re: Enhancing generic type documentation in the standard library

2022-03-23 Thread Brett Cannon
On Wed, Mar 23, 2022 at 11:03 AM Luciano Ramalho wrote: > Hello, everyone! > > I believe our documentation about types needs another overhaul. > The SC somewhat agrees!  See https://mail.python.org/archives/list/typing-...@python.org/thread/TVMQJXOJFOYFPDMQDFG6G4B6J3MLRYKB/ where we have asked

[Python-Dev] Re: C API: Move PEP 523 "Adding a frame evaluation API to CPython" private C API to the internal C API

2022-03-23 Thread Brett Cannon
On Wed, Mar 23, 2022 at 2:48 AM Petr Viktorin wrote: > On 22. 03. 22 19:07, Victor Stinner wrote: > > Hi, > > > > I proposed two PRs to move the private C API (Include/cpython/) of PEP > > 523 "Adding a frame evaluation API to CPython" to the internal C API > > (Include/internals/): > > > > *

[Python-Dev] Enhancing generic type documentation in the standard library

2022-03-23 Thread Luciano Ramalho
Hello, everyone! I believe our documentation about types needs another overhaul. We now have lots of generic types in the standard library, but their formal type parameters are poorly documented—or not documented at all—in the standard library documentation. More importantly: the documentation

[Python-Dev] Re: C API: Move PEP 523 "Adding a frame evaluation API to CPython" private C API to the internal C API

2022-03-23 Thread Steve Dower
On 3/22/2022 11:28 PM, Victor Stinner wrote: On Tue, Mar 22, 2022 at 7:33 PM Steve Dower wrote: After a normal deprecation period, yes? There is no backward compatibility warranty and no deprecation process for private APIs. And yet you're asking the question, which means you know these

[Python-Dev] Re: C API: Move PEP 523 "Adding a frame evaluation API to CPython" private C API to the internal C API

2022-03-23 Thread Petr Viktorin
On 22. 03. 22 19:07, Victor Stinner wrote: Hi, I proposed two PRs to move the private C API (Include/cpython/) of PEP 523 "Adding a frame evaluation API to CPython" to the internal C API (Include/internals/): * https://github.com/python/cpython/pull/32052 *