New submission from Andrés Delfino <adelf...@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@python
components: Documentation
messages: 319460
nosy: adelfino, docs@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 <rep...@bugs.python.org>
<https://bugs.python.org/issue33852>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to