[docs] [issue13658] Extra clause in class grammar documentation

Joshua Landau report at bugs.python.org
Fri Dec 23 16:31:54 CET 2011


New submission from Joshua Landau <joshua.landau.ws at gmail.com>:

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.

----------
assignee: docs at python
components: Documentation
messages: 150169
nosy: Joshua.Landau, docs at python
priority: normal
severity: normal
status: open
title: Extra clause in class grammar documentation
versions: Python 3.2

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue13658>
_______________________________________


More information about the docs mailing list