Issue 19289: Incorrect documentation for format's fill character. (original) (raw)

Issue19289

➜

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.

This issue has been migrated to GitHub: https://github.com/python/cpython/issues/63488

classification

process

Created on 2013-10-18 21:31 by eric.smith, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (4)
msg200308 - (view)	Author: Eric V. Smith (eric.smith) *	Date: 2013-10-18 21:31
In http://docs.python.org/library/string.html#format-specification-mini-language, it says "The fill character can be any character other than ‘{‘ or ‘}’." But that's not actually true. It's only true when using str.format, as it does the parsing and the { and } mean special things for that parser. But for format itself there is no restriction: >>> format(3, '{>10') '{{{{{{{{{3' As this section should be documenting the format specifiers themselves, I think it should not concern itself with restrictions imposed by str.format.
msg200331 - (view)	Author: Eric V. Smith (eric.smith) *	Date: 2013-10-18 23:36
See also issue 19238.
msg200653 - (view)	Author: Ezio Melotti (ezio.melotti) *	Date: 2013-10-20 23:36
I uploaded a patch on #19238 that also fixes this.
msg200658 - (view)	Author: Roundup Robot (python-dev)	Date: 2013-10-20 23:54
New changeset e3ff2065c548 by Ezio Melotti in branch '3.3': #19238, #19289: fix description of the align and fill values of the format specification. http://hg.python.org/cpython/rev/e3ff2065c548 New changeset f52892642c15 by Ezio Melotti in branch 'default': #19238, #19289: merge with 3.3. http://hg.python.org/cpython/rev/f52892642c15 New changeset 0592dc076bb7 by Ezio Melotti in branch '2.7': #19238, #19289: fix description of the align and fill values of the format specification. http://hg.python.org/cpython/rev/0592dc076bb7