Mailman 3 May 2020 - docs

[issue2897] Deprecate structmember.h
by Matthias Braun May 27, 2020

May 27, 2020

Matthias Braun <matthiasb(a)fb.com> added the comment: > The issue title is misleading, it says "Deprecate structmember.h". Is the plan still to deprecate it? Or to make it usable in the limited C API? Please update the title. As far as I understand it: The attached diff, moves the interesting declaration to `object.h` solving the limited API problem. And only leaves structmember.h around for backward compatibility for people using the "old" names `READONLY` or `RESTRICTED`. So in that sense it does deprecate structmember.h But indeed I hijacked this issue with my complaints about the limited API which may not have been the original intention here, but they get solved nonetheless. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue2897> _______________________________________

1 0

[issue2897] Deprecate structmember.h
by STINNER Victor May 27, 2020

May 27, 2020

STINNER Victor <vstinner(a)python.org> added the comment: > Note that structmember.h pollutes global namespace with macros that do not have conventional Py_ or PY_ prefix. READONLY and RESTRICTED macros seem to be most likely to conflict with other code. One small enhance would be to add such prefix when Py_LIMITED_API is defined. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue2897> _______________________________________

1 0

[issue2897] Deprecate structmember.h
by STINNER Victor May 27, 2020

May 27, 2020

STINNER Victor <vstinner(a)python.org> added the comment: > The proposed patch here, would fix this! The issue title is misleading, it says "Deprecate structmember.h". Is the plan still to deprecate it? Or to make it usable in the limited C API? Please update the title. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue2897> _______________________________________

1 0

[issue2897] Deprecate structmember.h
by Matthias Braun May 27, 2020

May 27, 2020

Change by Matthias Braun <matthiasb(a)fb.com>: ---------- components: +C API versions: +Python 3.10 -Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue2897> _______________________________________

1 0

[issue2897] Deprecate structmember.h
by Matthias Braun May 27, 2020

May 27, 2020

Matthias Braun <matthiasb(a)fb.com> added the comment: This wasn't mentioned before: Having PyMemberDef part of the structmember.h is a big problem for users of PEP384/limited API, because structmember.h is not part of it. Which results in the odd situation that `Py_tp_members` or `PyDescr_NewMember()` are part of the limited API but technically you cannot use it because you are not supposed to include headers that are not part of `Python.h`. The proposed patch here, would fix this! ---------- nosy: +Matthias Braun _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue2897> _______________________________________

1 0

Links to other versions of Python documenation not displaying properly on version 3.5
by Piotr Kramek May 26, 2020

May 26, 2020

Dear Sir/Madam I noticed that in the documentation for python 3.5: https://docs.python.org/3.5/ in the section "Docs for other versions" there are no links for versions newer than 3.8. The same is true for documentation for Python 2.7: https://docs.python.org/2.7/, but in that case the only version not displayed is version 3.10. I realize it is not strictly a bug but updating this section might improve navigation between different versions of the documentation. Sincerely Peter Kramek

1 0

[issue38580] select()'s documentation claims only sequences are accepted, but it allows all iterables
by Jakub Stasiak May 26, 2020

May 26, 2020

Jakub Stasiak <jakub+python.org(a)stasiak.at> added the comment: Cheers for backporting this, Tal, you beat me to it! ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38580> _______________________________________

1 0

[issue38580] select()'s documentation claims only sequences are accepted, but it allows all iterables
by miss-islington May 26, 2020

May 26, 2020

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset 500cd89ecce97750a1af32d4097d9945b7296bac by Miss Islington (bot) in branch '3.9': bpo-38580: Document that select() accepts iterables, not just sequences (GH-16832) https://github.com/python/cpython/commit/500cd89ecce97750a1af32d4097d9945b7… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38580> _______________________________________

1 0

[issue38580] select()'s documentation claims only sequences are accepted, but it allows all iterables
by Tal Einat May 26, 2020

May 26, 2020

Tal Einat <taleinat+python(a)gmail.com> added the comment: New changeset e3e800f3d28881cc9de38cd9bcbcf8fbdea238a6 by Tal Einat in branch '3.8': [3.8] bpo-38580: Document that select() accepts iterables, not just sequences (GH-16832) https://github.com/python/cpython/commit/e3e800f3d28881cc9de38cd9bcbcf8fbde… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38580> _______________________________________

1 0

[issue38580] select()'s documentation claims only sequences are accepted, but it allows all iterables
by Tal Einat May 26, 2020

May 26, 2020

Tal Einat <taleinat+python(a)gmail.com> added the comment: New changeset 3f215f35bdb9d666f5a692fc60f800da1bb1e4a9 by Tal Einat in branch '3.7': [3.7] bpo-38580: Document that select() accepts iterables, not just sequences (GH-16832) https://github.com/python/cpython/commit/3f215f35bdb9d666f5a692fc60f800da1b… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38580> _______________________________________

1 0