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 v+python
Recipients docs@python, v+python
Date 2017-12-09.21:36:38
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1512855398.42.0.213398074469.issue32263@psf.upfronthosting.co.za>
In-reply-to
Content
At least as far back as Python 3.1, the description for Template strings (section 6.1.5 in version 3.6.4rc1 docs) starts by differentiating what Template strings do, as:

Instead of the normal %-based substitutions, Templates support $-based substitutions, using the following rules:

Since this immediately follows a section describing the "Custom String Formatting" and the "Format Specification Mini-Language", which does a type of substitutions that is {} based, rather than % based, it is hard to grasp exactly why %-based substitutions would be considered "normal". Of course, I know why, due to the % operator, but for someone just reading through chapter 6, it is a reference that raises the mental question "Huh? What is normal %-based substitution? Are Templates abnormal, if %-based substitutions are normal? What did I miss? The previous section was about {}-based substitutions? Are they abnormal, too? What are normal %-based substitutions, anyway?" rather than helping to describe what Templates are and do.
History
Date User Action Args
2017-12-09 21:36:38v+pythonsetrecipients: + v+python, docs@python
2017-12-09 21:36:38v+pythonsetmessageid: <1512855398.42.0.213398074469.issue32263@psf.upfronthosting.co.za>
2017-12-09 21:36:38v+pythonlinkissue32263 messages
2017-12-09 21:36:38v+pythoncreate