[New-bugs-announce] [issue45647] "expression" is erroneous in the doc

[Arthur Milchior]

New submission from Arthur Milchior <arthur at milchior.fr>:

https://docs.python.org/3/reference/expressions.html#grammar-token-python-grammar-expression is wrong
This line state:
`expression             ::=  conditional_expression | lambda_expr`
and it is a problem because, by the way sphinx understand reference, this mean that any people who use the token `expression` will be linked to this particular line.
For example in https://docs.python.org/3/reference/expressions.html#grammar-token-python-grammar-key_datum
`key_datum          ::=  expression ":" expression | "**" or_expr`
while clearly a key_datum is not expecting only a conditional expression or a lambda expression.

Admittedly, you can derive, from  expression:
* conditional_expression
* or_test
* and_test
* not_test
* comparison
* or_expr
* xor_expr
* and_expr
* shift_expr
* a_expr
* m_expr
* u_expr
* power
* primary
* atom

in this order, so in practice you can probably derive most of the expressions. However, I doubt that this is what the documentation meant here, and clearly not practical.

----------
assignee: docs at python
components: Documentation
messages: 405189
nosy: Arthur-Milchior, docs at python
priority: normal
severity: normal
status: open
title: "expression" is erroneous in the doc
versions: Python 3.10, Python 3.11, Python 3.6, Python 3.7, Python 3.8, Python 3.9

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