Steven D'Aprano <steve+python@pearwood.info> 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 <report@bugs.python.org> <https://bugs.python.org/issue32452> _______________________________________

R. David Murray <rdmurray@bitdance.com> 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 <report@bugs.python.org> <https://bugs.python.org/issue32452> _______________________________________

Change by Emily Morehouse <emily@cuttlesoft.com>: ---------- nosy: +emilyemorehouse _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue32452> _______________________________________

Change by Roundup Robot <devnull@psf.upfronthosting.co.za>: ---------- pull_requests: +4956 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue32452> _______________________________________

R. David Murray <rdmurray@bitdance.com> 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/f24c1857a8a1ba3efb3f957d43371bc9499... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue32452> _______________________________________

Mariatta Wijaya <mariatta.wijaya@gmail.com> 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 <report@bugs.python.org> <https://bugs.python.org/issue32452> _______________________________________

R. David Murray <rdmurray@bitdance.com> 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 <report@bugs.python.org> <https://bugs.python.org/issue32452> _______________________________________