[issue5371] Documentation of str.format in library/stdtypes shows incorrect first parameter

[Mitchell Model]

New submission from Mitchell Model <mlm at acm.org>:

In the library documentation of standard types, the instance method 
str.format is shown as taking a format-specification as its first 
argument. I'm pretty sure that this is incorrect. When format is called 
through a string, it is that string that is the format specification.

That is, shouldn't
    format(format-specification-string, arg....) be equivalent to
    format-specification-string.format(arg....)
?

----------
assignee: georg.brandl
components: Documentation
messages: 82722
nosy: MLModel, georg.brandl
severity: normal
status: open
title: Documentation of str.format in library/stdtypes shows incorrect first parameter
versions: Python 2.6, Python 2.7, Python 3.0, Python 3.1

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