Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Extra clause in class grammar documentation #57867

Closed
JoshuaLandau mannequin opened this issue Dec 23, 2011 · 2 comments
Closed

Extra clause in class grammar documentation #57867

JoshuaLandau mannequin opened this issue Dec 23, 2011 · 2 comments
Labels
docs Documentation in the Doc dir

Comments

@JoshuaLandau
Copy link
Mannequin

JoshuaLandau mannequin commented Dec 23, 2011

BPO 13658
Nosy @terryjreedy

Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2011-12-24.02:02:26.873>
created_at = <Date 2011-12-23.15:31:53.760>
labels = ['docs']
title = 'Extra clause in class grammar documentation'
updated_at = <Date 2011-12-24.02:02:26.859>
user = 'https://bugs.python.org/JoshuaLandau'

bugs.python.org fields:

activity = <Date 2011-12-24.02:02:26.859>
actor = 'python-dev'
assignee = 'docs@python'
closed = True
closed_date = <Date 2011-12-24.02:02:26.873>
closer = 'python-dev'
components = ['Documentation']
creation = <Date 2011-12-23.15:31:53.760>
creator = 'Joshua.Landau'
dependencies = []
files = []
hgrepos = []
issue_num = 13658
keywords = []
message_count = 2.0
messages = ['150169', '150202']
nosy_count = 5.0
nosy_names = ['terry.reedy', 'cvrebert', 'docs@python', 'python-dev', 'Joshua.Landau']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue13658'
versions = ['Python 3.2']

@JoshuaLandau
Copy link
Mannequin Author

JoshuaLandau mannequin commented Dec 23, 2011

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.

@JoshuaLandau JoshuaLandau mannequin assigned docspython Dec 23, 2011
@JoshuaLandau JoshuaLandau mannequin added the docs Documentation in the Doc dir label Dec 23, 2011
@python-dev
Copy link
Mannequin

python-dev mannequin commented Dec 24, 2011

New changeset b65007ef59c0 by Benjamin Peterson in branch '3.2':
kill superfluous 'comprehension' case (closes bpo-13658)
http://hg.python.org/cpython/rev/b65007ef59c0

@python-dev python-dev mannequin closed this as completed Dec 24, 2011
@ezio-melotti ezio-melotti transferred this issue from another repository Apr 10, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir
Projects
None yet
Development

No branches or pull requests

0 participants