Mailman 3 March 2017 - docs

[issue10379] locale.format() input regression
by R. David Murray March 28, 2017

March 28, 2017

Changes by R. David Murray <rdmurray(a)bitdance.com>: ---------- stage: needs patch -> backport needed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10379> _______________________________________

1 0

[issue20314] Potentially confusing formulation in 6.1.4. Template strings
by Gerrit Holl March 28, 2017

March 28, 2017

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 text: > Instead of the normal %-based substitutions, Templates support $-based substitutions, using the following rules: 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 would suggest to resolve this issue by simply not mentioning %-based substitutions, replacing the sentence above by: > Templates support $-based substitutions, using the following rules: ---------- assignee: docs@python components: Documentation messages: 208553 nosy: Gerrit.Holl, docs@python priority: normal severity: normal status: open title: Potentially confusing formulation in 6.1.4. Template strings type: enhancement versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20314> _______________________________________

4 10

[issue19824] string.Template: Add PHP-style variable expansion example
by anatoly techtonik March 28, 2017

March 28, 2017

New submission from anatoly techtonik: http://docs.python.org/2/library/string.html#template-strings This class could be more useful with the following example: >>> from string import Template >>> t = Template('$who likes $what') >>> who = 'tim' >>> what = 'kung pao' >>> t.substitute(locals()) 'tim likes kung pao' This will help PHP folks to transition their .php files. ---------- assignee: docs@python components: Documentation messages: 204677 nosy: docs@python, techtonik priority: normal severity: normal status: open title: string.Template: Add PHP-style variable expansion example _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19824> _______________________________________

5 15

[issue29677] clarify docs about 'round()' accepting a negative integer for ndigits
by Cheryl Sabella March 28, 2017

March 28, 2017

Cheryl Sabella added the comment: Mariatta, Yes, thank you, I will work on a pull request to address Victor's comment. Since it's my first time, I hope to read through the contributing docs and get this done today or tomorrow. Thank you! ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29677> _______________________________________

1 0

[issue29913] ipadress compare_networks does not work according to documentation
by Roundup Robot March 28, 2017

March 28, 2017

Changes by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- pull_requests: +765 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29913> _______________________________________

1 0

[issue29913] ipadress compare_networks does not work according to documentation
by Sanjay March 28, 2017

March 28, 2017

Sanjay added the comment: ok I will update the doc ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29913> _______________________________________

1 0

[issue29677] clarify docs about 'round()' accepting a negative integer for ndigits
by Mariatta Wijaya March 28, 2017

March 28, 2017

Mariatta Wijaya added the comment: GH-357 is: https://github.com/python/cpython/pull/357/files :) ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29677> _______________________________________

1 0

[issue29677] clarify docs about 'round()' accepting a negative integer for ndigits
by Mariatta Wijaya March 28, 2017

March 28, 2017

Mariatta Wijaya added the comment: Cheryl, thank you for your interest in working on this issue. The original issue has been addressed in Gerrit Holl's PR. But it seems like the docs can be further improved. Here is Victor's comment about it: (copied from GH-357) ``` while we are modifying the doc, I dislike the start: "Return the floating point value number": number can be an integer. round(123, -2) doesn't use floating point numbers. Maybe rephrase to following text? Return number rounded to (...). number can be an integer or a floating point number. Or just remove "floating pointer number"? ``` Will you be interested in preparing a PR to address Victor's comment above? Thanks :) ---------- stage: -> needs patch versions: -Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29677> _______________________________________

1 0

[issue29677] clarify docs about 'round()' accepting a negative integer for ndigits
by Mariatta Wijaya March 28, 2017

March 28, 2017

Mariatta Wijaya added the comment: New changeset 8994f36287b068e8ea9a9230fc90eda72bf5fff0 by Mariatta in branch '3.5': bpo-29677: DOC: clarify documentation for `round` (GH-357) (GH-863) https://github.com/python/cpython/commit/8994f36287b068e8ea9a9230fc90eda72b… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29677> _______________________________________

1 0

[issue29677] clarify docs about 'round()' accepting a negative integer for ndigits
by Mariatta Wijaya March 28, 2017

March 28, 2017

Mariatta Wijaya added the comment: New changeset 596506216104613591218c2896cdb49fa0b7e5bb by Mariatta in branch '3.6': bpo-29677: DOC: clarify documentation for `round` (GH-357) (GH-862) https://github.com/python/cpython/commit/596506216104613591218c2896cdb49fa0… ---------- nosy: +Mariatta _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29677> _______________________________________

1 0