[docs] [issue33852] doc Remove parentheses from

Andrés Delfino report at bugs.python.org
Wed Jun 13 09:12:22 EDT 2018


New submission from Andrés Delfino <adelfino at gmail.com>:

I think the idea of having "list" inside parentheses is to document that in case of sequences, only "one-expression" expression lists are legal.

That being said, IMHO, explaining that in actual prose would be better, but removing the parentheses (taking into account that there's a description of what the expected evaluation of sequences subscription expression lists is) is enough, plus, it's the production list term's name.

If a prose is considered better, it could read:

"If the primary is a sequence, the expression list must be formed by only one expression, and it must evaluate to an integer or a slice (as discussed in the following section)."

Couldn't find the original author. It was committed before the move to mercurial, and I don't know if there's a subversion repo still available to see historical changes.

----------
assignee: docs at python
components: Documentation
messages: 319460
nosy: adelfino, docs at python
priority: normal
pull_requests: 7295
severity: normal
status: open
title: doc Remove parentheses from
type: enhancement
versions: Python 2.7, Python 3.6, Python 3.7, Python 3.8

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


More information about the docs mailing list