classification
Title: views are not sequences
Type: behavior Stage: resolved
Components: Documentation Versions: Python 3.6, Python 3.4, Python 3.5, Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: martin.panter Nosy List: akira, berker.peksag, docs@python, martin.panter, python-dev
Priority: normal Keywords: patch

Created on 2015-10-01 05:31 by akira, last changed 2015-10-07 10:46 by martin.panter. This issue is now closed.

Files
File name Uploaded Description Edit
dict-views-glossary.patch akira, 2015-10-01 05:31 review
dict-views-glossary-2.patch akira, 2015-10-01 23:59 review
Messages (8)
msg251995 - (view) Author: Akira Li (akira) * Date: 2015-10-01 05:31
The entry for *dict view* in the glossary may be clarified, to avoid
confusion with collection.abc.Sequence i.e., from:

  They are lazy sequences that will see changes in the underlying
  dictionary.

to something like:

  They provide a dynamic view on the dictionary’s entries, which means
  that when the dictionary changes, the view reflects these changes.

See https://mail.python.org/pipermail/python-ideas/2015-October/036682.html

I've attached the corresponding doc patch.
msg251996 - (view) Author: Martin Panter (martin.panter) * (Python committer) Date: 2015-10-01 06:16
If changing the glossary heading, make sure it is kept in alphabetical order and incoming links still work (e.g. look for `view` and <view>). And maybe “dictionary view” (full spelling, and singular) would be a more accurate heading.

The text changes look good however.
msg252073 - (view) Author: Akira Li (akira) * Date: 2015-10-01 23:59
Thank you for `view`, <view> hint. I did look for :term:`view` that was
obviously not enough.

The new patch contains the renamed entry in the correct place. All `view`, <view>`
occurrences dictionary view are updated now.
msg252456 - (view) Author: Martin Panter (martin.panter) * (Python committer) Date: 2015-10-07 09:47
Will commit this patch, except for the :dfn:`view` part. That isn’t a hyperlink, it just emphasizes the term.
msg252457 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2015-10-07 10:09
New changeset 92429e01f444 by Martin Panter in branch '3.4':
Issue #25286: Dictionary views are not sequences
https://hg.python.org/cpython/rev/92429e01f444

New changeset c29f1114ef65 by Martin Panter in branch '3.5':
Issue #25286: Merge dictionary view glossary from 3.4 into 3.5
https://hg.python.org/cpython/rev/c29f1114ef65

New changeset d43c33f032a2 by Martin Panter in branch '3.5':
Issue #25286: Update dictionary view link; patch by Akira Li
https://hg.python.org/cpython/rev/d43c33f032a2

New changeset 7067420c3e72 by Martin Panter in branch 'default':
Issue #25286: Merge dictionary view glossary from 3.5
https://hg.python.org/cpython/rev/7067420c3e72
msg252459 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2015-10-07 10:24
New changeset 41e1f2500047 by Martin Panter in branch '2.7':
Issue #25286: Dictionary views are not sequences
https://hg.python.org/cpython/rev/41e1f2500047
msg252461 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2015-10-07 10:40
New changeset 04815b55227f by Martin Panter in branch '2.7':
Issue #25286: Accidentally dropped "the"
https://hg.python.org/cpython/rev/04815b55227f
msg252462 - (view) Author: Martin Panter (martin.panter) * (Python committer) Date: 2015-10-07 10:46
Thanks Akira
History
Date User Action Args
2015-10-07 10:46:32martin.pantersetstatus: open -> closed
versions: + Python 2.7
messages: + msg252462

resolution: fixed
stage: commit review -> resolved
2015-10-07 10:40:55python-devsetmessages: + msg252461
2015-10-07 10:24:01python-devsetmessages: + msg252459
2015-10-07 10:09:32python-devsetnosy: + python-dev
messages: + msg252457
2015-10-07 09:47:54martin.pantersetnosy: + berker.peksag
messages: + msg252456

assignee: docs@python -> martin.panter
stage: patch review -> commit review
2015-10-01 23:59:25akirasetfiles: + dict-views-glossary-2.patch

messages: + msg252073
2015-10-01 06:16:58martin.pantersetnosy: + martin.panter

messages: + msg251996
stage: patch review
2015-10-01 05:31:31akiracreate