Mailman 3 June 2017 - docs

[issue30051] Document that the random module doesn't support fork
by Antoine Pitrou 13 Jun '17

13 Jun '17

Antoine Pitrou added the comment: Victor, this issue should be obsolete now that the global Random instance is reseeded after fork(). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30051> _______________________________________

1 0

[issue30644] [EASY][doc] Document that signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
by STINNER Victor 13 Jun '17

13 Jun '17

New submission from STINNER Victor: The signal.set_wakeup_fd() function is used to write signal numbers as bytes into a pipe, to be able to handle signals using a "regular" file descriptors instead of special signal handlers. https://docs.python.org/dev/library/signal.html Problem: it's not documented how to unregister the FD. I just saw "signal.set_wakeup_fd(-1)" in a Pull Request and realized that we forgot to document it: https://github.com/python/cpython/pull/2139/ This issue is an EASY issue: please leave it to real newcomers who didn't write any PR to CPython previously. Core developers: explain how to fix the issue, don't fix it ;-) Doc/library/signal.rst should be modified. I read that it's even possible to create a PR using an online editor? I never tried: https://github.com/python/cpython/blob/master/Doc/library/signal.rst ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30644> _______________________________________

2 7

[issue30644] [EASY][doc] Document that signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
by STINNER Victor 13 Jun '17

13 Jun '17

Changes by STINNER Victor <victor.stinner(a)gmail.com>: ---------- assignee: docs@python components: Documentation keywords: easy nosy: docs@python, haypo priority: normal severity: normal status: open title: [EASY][doc] Document that signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30644> _______________________________________

1 0

[issue30217] Missing entry for the tilde (~) operator in the Index
by Eric O. LEBIGOT 12 Jun '17

12 Jun '17

New submission from Eric O. LEBIGOT: The index (https://docs.python.org/3.6/genindex-Symbols.html) is missing an entry for the tilde operator ~ (there is also no entry under "tilde"). A relevant pointer could be to object.__invert__ (https://docs.python.org/3.6/reference/datamodel.html#object.__invert__). ---------- assignee: docs@python components: Documentation messages: 292641 nosy: docs@python, lebigot priority: normal severity: normal status: open title: Missing entry for the tilde (~) operator in the Index type: enhancement versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30217> _______________________________________

6 13

[issue30621] import json before using json module in tutorial Input and Output
by Masaki Suketa 11 Jun '17

11 Jun '17

New submission from Masaki Suketa: In Input and Output tutorial, use json module without `import json`. ---------- assignee: docs@python components: Documentation messages: 295626 nosy: docs@python, suketa priority: normal pull_requests: 2139 severity: normal status: open title: import json before using json module in tutorial Input and Output type: resource usage versions: Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30621> _______________________________________

2 9

[issue30312] Small correction in set code sample
by Oskar Weser 10 Jun '17

10 Jun '17

New submission from Oskar Weser: There is a code example about the set type found under: https://docs.python.org/3/tutorial/datastructures.html It reads as: ``` >>> basket = {'apple', 'orange', 'apple', 'pear', 'orange', 'banana'} >>> print(basket) # show that duplicates have been removed {'orange', 'banana', 'pear', 'apple'} >>> 'orange' in basket # fast membership testing True >>> 'crabgrass' in basket False >>> # Demonstrate set operations on unique letters from two words ... >>> a = set('abracadabra') >>> b = set('alacazam') >>> a # unique letters in a {'a', 'r', 'b', 'c', 'd'} >>> a - b # letters in a but not in b {'r', 'd', 'b'} >>> a | b # letters in either a or b ``` I read "either a or b" as "a .EXOR. b". Shouldn't it be: ``` >>> a | b # letters in a or b ``` I don't speak English as a native language, so perhaps I am wrong. ---------- assignee: docs@python components: Documentation messages: 293291 nosy: docs@python, mcocdawc priority: normal severity: normal status: open title: Small correction in set code sample versions: Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30312> _______________________________________

6 9

[issue25409] fnmatch.fnmatch normalizes slashes/backslashes on Windows
by Mariatta Wijaya 10 Jun '17

10 Jun '17

Mariatta Wijaya added the comment: This has been fixed, and backported to 2.7, 3.5, and 3.6. Thanks :) ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25409> _______________________________________

1 0

[issue25409] fnmatch.fnmatch normalizes slashes/backslashes on Windows
by Mariatta Wijaya 10 Jun '17

10 Jun '17

Mariatta Wijaya added the comment: New changeset 9660a7e4bbc3932846fcde0e31856b5b3908b834 by Mariatta in branch '2.7': bpo-25409: Clarify fnmatch and fnmatchcase documentation (GH-1535) (GH-2067) https://github.com/python/cpython/commit/9660a7e4bbc3932846fcde0e31856b5b39… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25409> _______________________________________

1 0

[issue25409] fnmatch.fnmatch normalizes slashes/backslashes on Windows
by Mariatta Wijaya 10 Jun '17

10 Jun '17

Mariatta Wijaya added the comment: New changeset 656f232131e7a49800662119c7f9b8078729e697 by Mariatta in branch '3.5': bpo-25409: Clarify fnmatch and fnmatchcase documentation (GH-1535) (GH-2066) https://github.com/python/cpython/commit/656f232131e7a49800662119c7f9b80787… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25409> _______________________________________

1 0

[issue25409] fnmatch.fnmatch normalizes slashes/backslashes on Windows
by Mariatta Wijaya 10 Jun '17

10 Jun '17

Mariatta Wijaya added the comment: New changeset 76eabd3a21dc578de6093d45dd8d69a5ec4b9afe by Mariatta in branch '3.6': bpo-25409: Clarify fnmatch and fnmatchcase documentation (GH-1535) (GH-2065) https://github.com/python/cpython/commit/76eabd3a21dc578de6093d45dd8d69a5ec… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25409> _______________________________________

1 0