[docs] [issue34531] doc Move comment about list sorting behavour outside impl-detail directive
report at bugs.python.org
Tue Aug 28 11:31:27 EDT 2018
New submission from Andrés Delfino <adelfino at gmail.com>:
As this text is phrased:
CPython implementation detail: While a list is being sorted, the effect of attempting to mutate, or even inspect, the list is undefined. The C implementation of Python makes the list appear empty for the duration, and raises ValueError if it can detect that the list has been mutated during a sort.
I take it that the first sentence is a general comment for all implementations, as the second sentence does define a specific behavior in CPython, so it's not undefined there.
I propose taking the first sentence out of the impl-detail directive.
assignee: docs at python
nosy: adelfino, docs at python
title: doc Move comment about list sorting behavour outside impl-detail directive
versions: Python 2.7, Python 3.6, Python 3.7, Python 3.8
Python tracker <report at bugs.python.org>
More information about the docs