[issue27484] Some Examples in Format String Syntax are incorrect or poorly worded

Change by Adam Meily : -- nosy: +meilyadam nosy_count: 5.0 -> 6.0 pull_requests: +26405 pull_request: https://github.com/python/cpython/pull/27959 ___ Python tracker ___

[issue27484] Some Examples in Format String Syntax are incorrect or poorly worded

Rufus V. Smith added the comment: 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

[issue27484] Some Examples in Format String Syntax are incorrect or poorly worded

R. David Murray added the comment: Agree with Zach. The example comments are correct as written, especially when considered in the context of the preceding example. -- nosy: +r.david.murray resolution: -> not a bug stage: -> resolved status: open -> closed

[issue27484] Some Examples in Format String Syntax are incorrect or poorly worded

Zachary Ware added the comment: 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". -- nosy: +zach.ware ___

[issue27484] Some Examples in Format String Syntax are incorrect or poorly worded

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

[issue27484] Some Examples in Format String Syntax are incorrect or poorly worded

New submission from Rufus V. Smith: 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}"