[issue32452] Brackets and Parentheses used in an ambiguous way

[R. David Murray]

R. David Murray  added the comment:

Thanks, Mariatta.  I did click on the details link, so either the restart link 
isn't obvious or I don't have the correct permissions to do a restart :)

And thanks Emily for doing the PR.

--
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[R. David Murray]

R. David Murray  added the comment:


New changeset 0e0d1017a4c8ad6f77ee42d7b640463058037f62 by R. David Murray (Miss 
Islington (bot)) in branch '2.7':
bpo-32452: clarify term 'brackets' in generator tutorial (GH-5079) (#5082)
https://github.com/python/cpython/commit/0e0d1017a4c8ad6f77ee42d7b640463058037f62


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[Mariatta Wijaya]

Mariatta Wijaya  added the comment:

I clicked the "Details" link and restarted the build from there.
Closing and reopening the PR will also restart the build.

--
nosy: +Mariatta

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[R. David Murray]

R. David Murray  added the comment:

It looks like the docs job hung on the 2.7 backport, but I don't see how to 
restart it.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[R. David Murray]

R. David Murray  added the comment:


New changeset f24c1857a8a1ba3efb3f957d43371bc9499e3c86 by R. David Murray (Miss 
Islington (bot)) in branch '3.6':
bpo-32452: clarify term 'brackets' in generator tutorial (GH-5079) (#5081)
https://github.com/python/cpython/commit/f24c1857a8a1ba3efb3f957d43371bc9499e3c86


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[Roundup Robot]

Change by Roundup Robot :


--
pull_requests: +4957

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[Roundup Robot]

Change by Roundup Robot :


--
pull_requests: +4956

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[R. David Murray]

R. David Murray  added the comment:


New changeset f190eb59e60e2ae7a7cbd396458389a7a076e0d3 by R. David Murray 
(Emily Morehouse) in branch 'master':
bpo-32452: clarify term 'brackets' in generator tutorial (#5079)
https://github.com/python/cpython/commit/f190eb59e60e2ae7a7cbd396458389a7a076e0d3


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[Emily Morehouse]

Change by Emily Morehouse :


--
nosy: +emilyemorehouse

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[Emily Morehouse]

Change by Emily Morehouse :


--
keywords: +patch
pull_requests: +4954
stage:  -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[R. David Murray]

R. David Murray  added the comment:

"round brackets" would require just as much thought (if not more...it's not a 
thing at all in American typographical language) for an American to understand 
as the unadorned bracket does for the rest of you, so the best compromise is 
"parenthesis instead of square brackets", since parenthesis is used elsewhere 
in the docs.

--
nosy: +r.david.murray

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[kandhan]

kandhan  added the comment:

"round brackets instead of square brackets" sounds better.

Its simple and direct and doesn't require any extra operations other than the 
required one.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[Steven D'Aprano]

Steven D'Aprano  added the comment:

In British, Australian, New Zealander, and Indian English (and sometimes 
Canada), at least, "bracket" on its own typically means round brackets () and 
is rarely if ever used for square brackets [] or curly brackets {} without the 
adjective.

See for example 
https://english.stackexchange.com/questions/168762/brackets-vs-parenthesis for 
a discussion.

Consequently, the phrase "parentheses instead of brackets" reads to us as 
"parentheses instead of parentheses" would to Americans. In other words, weird 
and requiring a moment (or three) of thought to translate.

I support the suggested change to "parentheses instead of square brackets" -- 
it should read more naturally to people in the British Commonwealth and (I 
hope) shouldn't look too strange to Americans.

My personal preference would be for "round brackets instead of square 
brackets", but I guess that will be a battle I have no hope of winning *wink*

--
nosy: +steven.daprano

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[kandhan]

kandhan  added the comment:

In the above comment,

Line 1 is the URL where it needs improvement

Line 2 and 3 are the actual content in the page that needs improvement

Line 4 is the proposed solution

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32452] Brackets and Parentheses used in an ambiguous way

[kandhan]

New submission from kandhan :

https://docs.python.org/3/tutorial/classes.html

9.10. Generator Expressions

Some simple generators can be coded succinctly as expressions using a syntax 
similar to list comprehensions but with "parentheses instead of brackets"

Since parentheses comes under brackets, brackets could be changed to "Square 
Brackets"

--
assignee: docs@python
components: Documentation
messages: 309216
nosy: docs@python, kandhan
priority: normal
severity: normal
status: open
title: Brackets and Parentheses used in an ambiguous way
type: enhancement
versions: Python 3.6

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com