Mailman 3 January 2016 - docs

[issue23762] python.org page on new-style classes should be updated
by Joël Schaerer 13 Jan '16

13 Jan '16

New submission from Joël Schaerer: This page (found it via a search engine): https://www.python.org/doc/newstyle/ is supposed to give the status of "New-style classes". However this information is no longer relevant for Python 3, and my needlessly scare newcomers. I believe it should be either deleted or updated to mention that python3 users don't need to care about this anymore. ---------- assignee: docs@python components: Documentation messages: 239127 nosy: docs@python, joelthelion priority: normal severity: normal status: open title: python.org page on new-style classes should be updated type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23762> _______________________________________

4 5

[issue26087] PEP 0373 should be updated
by Chi Hsuan Yen 13 Jan '16

13 Jan '16

New submission from Chi Hsuan Yen: Current PEP 0373 lists Python 2.7.11 as a future release, and there's no information about Python 2.7.12. Please update it, thanks! ---------- assignee: docs@python components: Documentation messages: 258063 nosy: Chi Hsuan Yen, docs@python priority: normal severity: normal status: open title: PEP 0373 should be updated versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26087> _______________________________________

3 2

[issue25574] 2.7 incorrectly documents objects hash as equal to id
by wim glenn 12 Jan '16

12 Jan '16

New submission from wim glenn: The 2.7 glossary still incorrectly mentions instances of user-defined classes hash equal to their id. https://docs.python.org/2/glossary.html#term-hashable Just a minor documentation bug that was unfortunately missed by http://bugs.python.org/issue21782 ---------- assignee: docs@python components: Documentation files: mywork.patch keywords: patch messages: 254237 nosy: docs@python, wim.glenn priority: normal severity: normal status: open title: 2.7 incorrectly documents objects hash as equal to id versions: Python 2.7 Added file: http://bugs.python.org/file40966/mywork.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25574> _______________________________________

4 3

[issue26001] Tutorial: write() does not expect string in binary mode
by Dimitri Papadopoulos Orfanos 12 Jan '16

12 Jan '16

New submission from Dimitri Papadopoulos Orfanos: About section "7.2.1. Methods of File Objects" of the tutorial: 1. Method read() is documented as follows: reads some quantity of data and returns it as a string or bytes object. Indeed read() returns a string in text mode and bytes in binary mode. For the sake of clarity, I suggest changing to: reads some quantity of data and returns it as a string (in text mode) or bytes object (in binary mode). This might seem long-winded but I believe it would help those moving from Python 2 to Python 3. 2. Method write() is documented as follows: To write something other than a string, it needs to be converted to a string first While this is correct in text mode, it is wrong in binary mode. May I suggest: To write something other than a string (in text mode) or bytes object (in binary mode), it needs to be converted first ---------- assignee: docs@python components: Documentation messages: 257418 nosy: Dimitri Papadopoulos Orfanos, docs@python priority: normal severity: normal status: open title: Tutorial: write() does not expect string in binary mode versions: Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26001> _______________________________________

6 6

[issue19006] UnitTest docs should have a single list of assertions
by Roy Smith 12 Jan '16

12 Jan '16

New submission from Roy Smith: http://docs.python.org/2/library/unittest.html#assert-methods The docs say, "The TestCase class provides a number of methods to check for and report failures, such as", and then when you scroll a couple of screens down, there's another list, "There are also other methods used to perform more specific checks, such as". These should be merged into a single list. There's nothing fundamentally different about the two lists and breaking them into two parts just makes it harder to find what you want. ---------- assignee: docs@python components: Documentation messages: 197492 nosy: docs@python, roysmith priority: normal severity: normal status: open title: UnitTest docs should have a single list of assertions versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19006> _______________________________________

7 11

[issue25991] readline example eventually consumes all memory
by Bruce Frederiksen 12 Jan '16

12 Jan '16

New submission from Bruce Frederiksen: The Example in the readline documentation (section 6.7 of the Library Reference) shows how to save your readline history in a file, and restore it each time you start Python. The problem with the Example is that it does not include a call to readline.set_history_length and the default is -1 (infinite). As a Python developer, I start Python quite a lot and had a .python_history file that was 850M bytes. Just starting Python was causing my system to thrash before the first prompt (>>>) even appeared. I suggest adding the following line to the example to avoid this: readline.set_history_length(1000) I'm not sure how far back this goes in terms of earlier versions of Python, but probably quite far. ---------- assignee: docs@python components: Documentation messages: 257325 nosy: dangyogi, docs@python priority: normal severity: normal status: open title: readline example eventually consumes all memory type: resource usage versions: Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25991> _______________________________________

5 6

[issue25517] regex howto example in "Lookahead Assertions"
by Pavel 11 Jan '16

11 Jan '16

New submission from Pavel: The example advises ".*[.](?!bat$).*$" expression "to match filenames where the extension is not bat". But here is an example which passes such check: >>> re.match("(.*)[.](?!bat$).*$", "test.a.bat") <_sre.SRE_Match object at 0x7ff221996f30> To my mind use of negative lookbehind expressions (not covered so far in the HOWTO) is better: >>> re.match("(.*)[.].*(?<!.bat)$", "test.a.bat") >>> ---------- assignee: docs@python components: Documentation messages: 253725 nosy: Pavel, docs@python priority: normal severity: normal status: open title: regex howto example in "Lookahead Assertions" type: behavior versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25517> _______________________________________

5 5

[issue26080] "abandonned" -> "abandoned" in PEP 510's https://hg.python.org/peps/rev/b463c740990c
by W. Trevor King 11 Jan '16

11 Jan '16

New submission from W. Trevor King: In the recently-landed [1], There was also the Unladen Swallow project, but it was abandonned in 2011. Should have used “abandoned” instead of “abandonned”. [1]: https://hg.python.org/peps/rev/b463c740990c changeset: 6155:b463c740990c user: Victor Stinner <victor.stinner< at >gmail.com> date: Sun Jan 10 14:58:17 2016 +0100 summary: PEP 510: rationale for static optimize vs JIT compiler http://permalink.gmane.org/gmane.comp.python.cvs/114604 ---------- assignee: docs@python components: Documentation messages: 257974 nosy: docs@python, labrat priority: normal severity: normal status: open title: "abandonned" -> "abandoned" in PEP 510's https://hg.python.org/peps/rev/b463c740990c type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26080> _______________________________________

3 2

[issue1753718] base64 "legacy" functions violate RFC 3548
by Martin Panter 10 Jan '16

10 Jan '16

Martin Panter added the comment: Uploaded a Python 3 patch to Issue 22088 which includes the doc string changes. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1753718> _______________________________________

1 0

[issue8810] TZ offset description is unclear in docs
by Stéphane Wirtel 10 Jan '16

10 Jan '16

Stéphane Wirtel added the comment: Hi Martin, Which patch? Thanks -- Stéphane Wirtel - http://wirtel.be - @matrixise ---------- nosy: +matrixise _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8810> _______________________________________

1 0