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.

Author Ken.Basye
Recipients Ken.Basye, docs@python
Date 2010-09-08.22:08:36
SpamBayes Score 1.0769684e-06
Marked as misclassified No
Message-id <1283983718.4.0.736400654813.issue9805@psf.upfronthosting.co.za>
In-reply-to
Content
From http://docs.python.org/library/stdtypes.html#string-formatting-operations :

"When the right argument is a dictionary (or other mapping type), then the formats in the string must include a parenthesised mapping key into that dictionary inserted immediately after the '%' character."  
(with emphasis on 'must' in the HTML, BTW).  

This isn't correct:  "%s" % dict() is a perfectly legal expression with a dictionary as the right argument and no mapping key in the formats.  Indeed, if the current doc were correct, there would apparently be no way to format an empty dictionary.

How about this one-word fix:

"When the right argument is a dictionary (or other mapping type), then the formats in the string may include ..." and so on into the next sentence, and no emphasis on 'may'.






P.S. Not sure about the Type of this issue, and it's present in both 2.7 and current 3.X doc.
History
Date User Action Args
2010-09-08 22:08:38Ken.Basyesetrecipients: + Ken.Basye, docs@python
2010-09-08 22:08:38Ken.Basyesetmessageid: <1283983718.4.0.736400654813.issue9805@psf.upfronthosting.co.za>
2010-09-08 22:08:36Ken.Basyelinkissue9805 messages
2010-09-08 22:08:36Ken.Basyecreate