Missing documentation for Py_TPFLAGS_HAVE_NEWBUFFER

[GiacomoAlzetta]

BPO	23850
Nosy	@serhiy-storchaka, @Mariatta, @ndevenish

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2020-05-31.13:33:31.282>
created_at = <Date 2015-04-02.10:09:33.694>
labels = ['type-feature', 'docs']
title = 'Missing documentation for Py_TPFLAGS_HAVE_NEWBUFFER'
updated_at = <Date 2020-05-31.13:33:31.281>
user = 'https://bugs.python.org/GiacomoAlzetta'

bugs.python.org fields:

activity = <Date 2020-05-31.13:33:31.281>
actor = 'serhiy.storchaka'
assignee = 'docs@python'
closed = True
closed_date = <Date 2020-05-31.13:33:31.282>
closer = 'serhiy.storchaka'
components = ['Documentation']
creation = <Date 2015-04-02.10:09:33.694>
creator = 'Giacomo.Alzetta'
dependencies = []
files = []
hgrepos = []
issue_num = 23850
keywords = []
message_count = 4.0
messages = ['239895', '320897', '320901', '370451']
nosy_count = 5.0
nosy_names = ['docs@python', 'serhiy.storchaka', 'Giacomo.Alzetta', 'Mariatta', 'ndevenish']
pr_nums = []
priority = 'normal'
resolution = 'out of date'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue23850'
versions = ['Python 2.7']

[GiacomoAlzetta]

Python2.7 documentation is missing critical information regarding the backporting of the new-buffer protocol.
There is no mention whatsoever of the Py_TPFLAGS_HAVE_NEWBUFFER flag which is required to implement it. The only way to discover it is by reading the sources of the built-ins or stdlib.

[ndevenish]

I've just spent some time running around because of this. Are documentation contributions still being accepted for python 2.7 at all? Some of the buffer documentation seems to be confusing as to whether you use new or old API.

[Mariatta]

Documentation fixes to 2.7 is still accepted. Please create a PR on GitHub.

[serhiy-storchaka]

Python 2.7 is no longer supported.