[New-bugs-announce] [issue27484] Some Examples in Format String Syntax are incorrect or poorly worded

[Rufus V. Smith]

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}"                      # 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)

----------
assignee: docs at python
components: Documentation
messages: 270189
nosy: RufusVS, docs at python
priority: normal
severity: normal
status: open
title: Some Examples in Format String Syntax are incorrect or poorly worded

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue27484>
_______________________________________