[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2017-03-28 Thread Barry A. Warsaw
Changes by Barry A. Warsaw : -- versions: +Python 3.7 -Python 2.7, Python 3.3, Python 3.4 ___ Python tracker ___

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2017-03-28 Thread Barry A. Warsaw
Changes by Barry A. Warsaw : -- resolution: -> fixed stage: -> resolved status: open -> closed ___ Python tracker ___

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2017-03-28 Thread Barry A. Warsaw
Barry A. Warsaw added the comment: New changeset 9f74deba784fc8781d13ed564f69c02ed7c331bb by Barry Warsaw in branch 'master': Improve the documentation for template strings (#856) https://github.com/python/cpython/commit/9f74deba784fc8781d13ed564f69c02ed7c331bb --

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2017-03-27 Thread Barry A. Warsaw
Changes by Barry A. Warsaw : -- pull_requests: +759 ___ Python tracker ___ ___

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2017-03-27 Thread Barry A. Warsaw
Changes by Barry A. Warsaw : -- assignee: docs@python -> barry ___ Python tracker ___ ___

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2014-01-20 Thread Gerrit Holl
New submission from Gerrit Holl: The standard library documentation “6.1. string — Common string operations” describes string formatting through the `.format` method and the corresponding mini-language, and the `Template` class. In the part describing the `Template` class (6.1.4) is the

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2014-01-20 Thread Georg Brandl
Georg Brandl added the comment: +1. -- nosy: +georg.brandl ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20314 ___ ___ Python-bugs-list mailing

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2014-01-20 Thread Barry A. Warsaw
Barry A. Warsaw added the comment: On Jan 20, 2014, at 05:10 PM, Gerrit Holl wrote: This is potentially confusing. The documentation in this section has not made any mention of %-based substitutions. Rather, a novel reader may, at this point, think that {}-based substitution is normal. I

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2014-01-20 Thread Zachary Ware
Zachary Ware added the comment: I would suggest moving the section 4.7.2. printf-style String Formatting from stdtypes to string, alongside the other two formatting specifications, or otherwise moving %-formatting and {}-formatting into the same page that is not stdtypes. 4.7.2 is a pretty

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2014-01-20 Thread Zachary Ware
Changes by Zachary Ware zachary.w...@gmail.com: -- versions: +Python 2.7, Python 3.4 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20314 ___ ___

[issue20314] Potentially confusing formulation in 6.1.4. Template strings

2014-01-20 Thread Georg Brandl
Georg Brandl added the comment: I would suggest moving the section 4.7.2. printf-style String Formatting from stdtypes to string That's something I wanted to do for a long time. Problem is that non-Intersphinx external links will break (and I guess quite a few people have a bookmark on