➜
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.
Created on 2016-07-11 16:56 by RufusVS, last changed 2022-04-11 14:58 by admin. This issue is now closed.
| Pull Requests | |||
|---|---|---|---|
| URL | Status | Linked | Edit |
| PR 27959 | open | meilyadam, 2021-08-26 00:56 | |
| Messages (5) | |||
|---|---|---|---|
| msg270189 - (view) | Author: Rufus V. Smith (RufusVS) | Date: 2016-07-11 16:56 | |
In section 6.1.3 Format String Syntax, some examples have incorrect or poorly worded comments:
Original:
"Harold's a clever {0!s}" # Calls str() on the argument first
"Bring out the holy {name!r}" # Calls repr() on the argument first
"More {!a}" # Calls ascii() on the argument first
Suggested Changes:
"Harold's a clever {0!s}" # Calls str() on first positional argument
"Bring out the holy {name!r}" # Calls repr() on the named argument 'name'
"More {!a}" # Calls ascii() on first positional argument (v. 3.1 and later)
|
|||
| msg270194 - (view) | Author: Raymond Hettinger (rhettinger) *  |
Date: 2016-07-11 18:10 | |
I think all of these read fine as-is though I would change "argument first" to "first argument" or just "argument". Adding the word "positional" is a distractor from what the comments are trying to communicate. The version numbering is normally done with a directive and outside of the examples. |
|||
| msg270197 - (view) | Author: Zachary Ware (zach.ware) * |
Date: 2016-07-11 18:29 | |
I don't think "argument first" should be changed to "first argument": the point is that the converter is called on the argument before it's formatted into the string, the call is done "first". |
|||
| msg270203 - (view) | Author: R. David Murray (r.david.murray) * |
Date: 2016-07-11 20:18 | |
Agree with Zach. The example comments are correct as written, especially when considered in the context of the preceding example. |
|||
| msg303504 - (view) | Author: Rufus V. Smith (RufusVS) | Date: 2017-10-02 00:37 | |
I happened to run across this in my old email inbox. It's embarrassing to realize how wrong I was in submitting the report. Reading it with fresh eyes, your original makes sense. I don't know what I was thinking. > On Jul 11, 2016, at 2:10 PM, Raymond Hettinger <report@bugs.python.org> wrote: > > > Raymond Hettinger added the comment: > > I think all of these read fine as-is though I would change "argument first" to "first argument" or just "argument". Adding the word "positional" is a distractor from what the comments are trying to communicate. > > The version numbering is normally done with a directive and outside of the examples. > > ---------- > nosy: +rhettinger > > _______________________________________ > Python tracker <report@bugs.python.org> > <http://bugs.python.org/issue27484> > _______________________________________ |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022-04-11 14:58:33 | admin | set | github: 71671 |
| 2021-08-26 00:56:20 | meilyadam | set | nosy:
+ meilyadam pull_requests: + pull_request26405 |
| 2017-10-02 00:37:19 | RufusVS | set | messages: + msg303504 |
| 2016-07-11 20:18:35 | r.david.murray | set | status: open -> closed nosy: + r.david.murray messages: + msg270203 resolution: not a bug stage: resolved |
| 2016-07-11 18:29:31 | zach.ware | set | nosy:
+ zach.ware messages: + msg270197 |
| 2016-07-11 18:10:42 | rhettinger | set | nosy:
+ rhettinger messages: + msg270194 |
| 2016-07-11 16:56:56 | RufusVS | create | |