[issue34531] doc Move comment about list sorting behavour outside impl-detail directive

[Raymond Hettinger]

Raymond Hettinger  added the comment:

The sentence should be left as-is.  It is there to make the following two 
sentences more intelligible.

The docs otherwise make no promises about other implementations and this is as 
it should be.

--
nosy: +rhettinger
resolution:  -> rejected
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue34531] doc Move comment about list sorting behavour outside impl-detail directive

[Andrés Delfino]

Change by Andrés Delfino :


--
keywords: +patch
pull_requests: +8450
stage:  -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue34531] doc Move comment about list sorting behavour outside impl-detail directive

[Andrés Delfino]

New submission from Andrés Delfino :

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@python
components: Documentation
messages: 324259
nosy: adelfino, docs@python
priority: normal
severity: normal
status: open
title: doc Move comment about list sorting behavour outside impl-detail 
directive
type: enhancement
versions: Python 2.7, Python 3.6, Python 3.7, Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com