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 r.david.murray
Recipients eric.smith, hugo.prodhomme@gmx.fr, r.david.murray
Date 2017-02-10.14:59:34
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1486738775.17.0.428835926971.issue29526@psf.upfronthosting.co.za>
In-reply-to
Content
Thanks for wanting to help improve python.

I'm not entirely clear on what you are proposing.  I *think* you want to add something to the 'format' docstring?  As Eric mentioned the 'mini language' depends on the datatype, so it is going to be hard to cram accurate information into a docstring, where the full context of the documentation explanation of how format interacts with data types is missing.  We try to keep docstrings as short reminders.  In that regard, the format docstring *is* perhaps a bit lacking :)  A reminder of the BNF of the minilanguage would also be helpful if we could cram that in somehow.  It may just be too complex a topic for a docstring, though.

I'm also not clear why you are referring to strftime and numbers in the same sentence.  strftime is for date formatting.  I certainly don't think it is appropriate to try to jam that complex subtopic into the format docstring :)  Maybe you meant 'printf', which % formatting followed fairly closely?
History
Date User Action Args
2017-02-10 14:59:35r.david.murraysetrecipients: + r.david.murray, eric.smith, hugo.prodhomme@gmx.fr
2017-02-10 14:59:35r.david.murraysetmessageid: <1486738775.17.0.428835926971.issue29526@psf.upfronthosting.co.za>
2017-02-10 14:59:35r.david.murraylinkissue29526 messages
2017-02-10 14:59:34r.david.murraycreate