[issue43996] Doc for mutable sequence pop() method implies argument is a slice or sequence.

Mark Sapiro report at bugs.python.org
Fri Apr 30 20:34:44 EDT 2021


New submission from Mark Sapiro <mark at msapiro.net>:

In several places in the documentation including:

```
grep -rn 'pop.\[i\]'
Lib/pydoc_data/topics.py:13184:             '| "s.pop([i])"                   | retrieves the item at *i* '
Lib/pydoc_data/topics.py:13647:                     '| "s.pop([i])"                   | retrieves the item at '
Doc/tutorial/datastructures.rst:47:.. method:: list.pop([i])
Doc/library/array.rst:193:.. method:: array.pop([i])
Doc/library/stdtypes.rst:1116:| ``s.pop([i])``               | retrieves the item at *i* and  | \(2)                |
```
the mutable sequence and array `pop()` method is documented as shown above in a way that implies the argument to `pop()` is a slice or sequence when it is actually just an integer. All those references should be `pop(i)` rather than `pop([i])`.

----------
assignee: docs at python
components: Documentation
messages: 392551
nosy: docs at python, msapiro
priority: normal
severity: normal
status: open
title: Doc for mutable sequence pop() method implies argument is a slice or sequence.
type: behavior
versions: Python 3.10, Python 3.11, Python 3.8, Python 3.9

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue43996>
_______________________________________


More information about the Python-bugs-list mailing list