New submission from sgal <chrom...@outlook.com>:

In current Python document (3.7 - 3.9) there is such statement in documentation 
of Integer Objects:

The current implementation keeps an array of integer objects for all integers 
between ``-5`` and ``256``, when you create an int in that range you actually 
just get back a reference to the existing object. So it should be possible to 
change the value of ``1``.  I suspect the behaviour of Python in this case is 
undefined. :-)

The last sentence is vague. It is irresponsible to write "I suspect" in 
documentation. And as the statements ahead has already clarified the sense that 
this is "a current implementation", the last sentence should be removed.

----------
assignee: docs@python
components: Documentation
messages: 347990
nosy: docs@python, sgal
priority: normal
severity: normal
status: open
title: Remove a vague statement in documentation of Integer Objects
type: enhancement
versions: Python 3.7, Python 3.8, Python 3.9

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue37599>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to