Mailman 3 May 2019 - docs

[issue9267] Update pickle opcode documentation in pickletools for 3.x
by Windson Yang May 14, 2019

May 14, 2019

Windson Yang <wiwindson(a)outlook.com> added the comment: Where are the documents actually? ---------- nosy: +Windson Yang _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue9267> _______________________________________

1 0

[issue30535] Warn that meta_path is not empty
by Xavier Morel May 14, 2019

May 14, 2019

New submission from Xavier Morel: Encountered this issue porting Python 2 code manipulating meta_path to Python 3. In Python 2, meta_path is empty by default and its documentation specifically notes that: > sys.meta_path is searched before any implicit default finders or sys.path. As a result, sys.meta_path.append() works perfectly well and is overwhelmingly common[0]. In Python 3, this note was removed but the documentation does not specifically state default finders are present in meta_path, and the old code using sys.meta_path.append may now break as the default finders will silently take precedence on the custom ones if they believe they can do the job. I'd like to add a warning to the Python 3 documentation (3.5+?) noting the presence of existing default loaders, and to the Python 2 documentation suggesting `sys.meta_path.insert(0, finder)` for future-proofing, would there be objections or issues? [0] https://github.com/search?q=meta_path.append&type=Code&utf8=✓ ---------- assignee: docs@python components: Documentation messages: 294919 nosy: docs@python, xmorel priority: normal severity: normal status: open title: Warn that meta_path is not empty type: behavior versions: Python 2.7, Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30535> _______________________________________

6 13

[issue35138] timeit documentation should have example with function arguments
by davidak May 13, 2019

May 13, 2019

New submission from davidak <bugs.python.org+xdnb(a)davidak.de>: It is described here: https://www.pythoncentral.io/time-a-python-function/ I have just tested it. Works as expected. Best would be if timeit supports this natively. ---------- assignee: docs@python components: Documentation messages: 329079 nosy: davidak, docs@python priority: normal severity: normal status: open title: timeit documentation should have example with function arguments versions: Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35138> _______________________________________

5 7

[issue22021] shutil.make_archive() root_dir do not work
by Cheryl Sabella May 13, 2019

May 13, 2019

Cheryl Sabella <cheryl.sabella(a)gmail.com> added the comment: @giampaolo.rodola, no problem. I intended this more as a general request rather than something for right now. If you do have any availability at some point, please keep this one in mind. Thanks! ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22021> _______________________________________

1 0

[issue13286] PEP 3151 breaks backward compatibility: it should be documented
by STINNER Victor May 13, 2019

May 13, 2019

New submission from STINNER Victor <victor.stinner(a)haypocalc.com>: The following example works on Python 2.7 and 3.2, but fails on Python 3.3: ----------- import errno import os try: os.rmdir("testdir") except: pass os.mkdir("testdir") try: try: os.mkdir("testdir") except IOError as exc: # If can't get proper access, then just forget about writing # the data. if exc.errno == errno.EACCES: pass else: raise except OSError as exc: # Probably another Python process already created the dir. if exc.errno == errno.EEXIST: pass else: raise except Exception: print("PEP 3151 broke backward compatibility on such pattern!") ----------- I noticed the problem while reading the changeset e4d44c2e8e81. ---------- assignee: docs@python components: Documentation messages: 146562 nosy: docs@python, flox, haypo, pitrou priority: normal severity: normal status: open title: PEP 3151 breaks backward compatibility: it should be documented versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13286> _______________________________________

5 8

[issue22021] shutil.make_archive() root_dir do not work
by Giampaolo Rodola' May 13, 2019

May 13, 2019

Giampaolo Rodola' <g.rodola(a)gmail.com> added the comment: @cheryl.sabella don't have the bandwidth right now (traveling), sorry. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22021> _______________________________________

1 0

[issue33882] doc Mention breakpoint() in debugger-related FAQ
by Andrés Delfino May 13, 2019

May 13, 2019

New submission from Andrés Delfino <adelfino(a)gmail.com>: IMHO, it's a good opportunity to advertise the convenience of breakpoint(). PR adds a mention. ---------- assignee: docs@python components: Documentation messages: 319796 nosy: adelfino, docs@python priority: normal severity: normal status: open title: doc Mention breakpoint() in debugger-related FAQ type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33882> _______________________________________

4 5

[issue36008] [good first issue] Update documentation for 3.8
by Cheryl Sabella May 13, 2019

May 13, 2019

New submission from Cheryl Sabella <cheryl.sabella(a)gmail.com>: Please save this issue for a new contributor. If you have previously made a pull request to CPython, consider leaving this issue for someone else. Thanks! Similar to what PR 9501 did for updating references in the docs from 3.6 to 3.7, an update needs to be done for 3.8. ---------- assignee: docs@python components: Documentation keywords: easy messages: 335663 nosy: cheryl.sabella, docs@python priority: normal severity: normal stage: needs patch status: open title: [good first issue] Update documentation for 3.8 type: enhancement versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue36008> _______________________________________

5 10

[issue22021] shutil.make_archive() root_dir do not work
by Cheryl Sabella May 13, 2019

May 13, 2019

Cheryl Sabella <cheryl.sabella(a)gmail.com> added the comment: @giampaolo.rodola, would you be able to provide a review of this doc change? Thanks! ---------- nosy: +cheryl.sabella, giampaolo.rodola versions: -Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22021> _______________________________________

1 0

[issue36822] Minor grammatical fix in glossary.rst
by Sanyam Khurana May 12, 2019

May 12, 2019

New submission from Sanyam Khurana <sanyam.khurana01(a)gmail.com>: While working on translations, I saw a minor grammatical error in `Doc/glossary.rst`: ``` * The default Python prompt of the interactive shell when entering code for an indented code block ... ``` should be ``` * The default Python prompt of the interactive shell when entering the code for an indented code block ... ``` Attaching the path with this. ---------- assignee: docs@python components: Documentation messages: 341665 nosy: CuriousLearner, docs@python priority: normal severity: normal stage: needs patch status: open title: Minor grammatical fix in glossary.rst type: enhancement versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue36822> _______________________________________

3 6