This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: "expression" is erroneous in the doc
Type: Stage:
Components: Documentation Versions: Python 3.11, Python 3.10, Python 3.9
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: Arthur-Milchior, docs@python
Priority: normal Keywords:

Created on 2021-10-28 14:51 by Arthur-Milchior, last changed 2022-04-11 14:59 by admin.

Messages (1)
msg405189 - (view) Author: Arthur Milchior (Arthur-Milchior) * Date: 2021-10-28 14:51
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.
History
Date User Action Args
2022-04-11 14:59:51adminsetgithub: 89810
2021-11-02 16:23:39terry.reedysetversions: - Python 3.6, Python 3.7, Python 3.8
2021-10-28 14:51:26Arthur-Milchiorcreate