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: Extra clause in class grammar documentation
Type: Stage: resolved
Components: Documentation Versions: Python 3.2
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: Joshua.Landau, cvrebert, docs@python, python-dev, terry.reedy
Priority: normal Keywords:

Created on 2011-12-23 15:31 by Joshua.Landau, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (2)
msg150169 - (view) Author: Joshua Landau (Joshua.Landau) * Date: 2011-12-23 15:31
Inside the grammar for classes[1], the documentation states that the inheritance list can be of type:
"(" [argument_list [","] | comprehension] ")"

The "comprehension" part seems to be superfluous, especially as it is valid grammar without the clause.

The 2.7 docs state just "[expression list]", so either the addition should be justified or the extra clause removed.

[1] http://docs.python.org/py3k/reference/compound_stmts.html#grammar-token-classdef

Please see http://mail.python.org/pipermail/python-list/2011-December/1284989.html for discussion.
msg150202 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2011-12-24 02:02
New changeset b65007ef59c0 by Benjamin Peterson in branch '3.2':
kill superfluous 'comprehension' case (closes #13658)
http://hg.python.org/cpython/rev/b65007ef59c0
History
Date User Action Args
2022-04-11 14:57:25adminsetgithub: 57867
2011-12-24 02:02:26python-devsetstatus: open -> closed

nosy: + python-dev
messages: + msg150202

resolution: fixed
stage: resolved
2011-12-24 00:19:42terry.reedysetnosy: + terry.reedy
2011-12-23 21:23:31cvrebertsetnosy: + cvrebert
2011-12-23 15:31:53Joshua.Landaucreate