Mailman 3 November 2018 - docs

[issue22021] shutil.make_archive() root_dir do not work
by Lysandros Nikolaou Nov. 6, 2018

Nov. 6, 2018

Lysandros Nikolaou <lisandrosnik(a)gmail.com> added the comment: Since Serhiy said that this is a pure documentation issue, I thought that a doc PR is all that was needed, which I would be happy to make. Am I missing something here? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22021> _______________________________________

1 0

[issue22021] shutil.make_archive() root_dir do not work
by STINNER Victor Nov. 6, 2018

Nov. 6, 2018

STINNER Victor <vstinner(a)redhat.com> added the comment: > Is anybody working on this or can I submit a PR? Yes: Joannah Nanjekye wrote PR 10191 (from Issue22021.patch) which has been rejected. This issue is more complex from what it looks. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22021> _______________________________________

1 0

[issue23220] IDLE: Document how Shell displays user code output
by Terry J. Reedy Nov. 6, 2018

Nov. 6, 2018

Change by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- keywords: +patch pull_requests: +9656 stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue23220> _______________________________________

1 0

[issue35119] Customizing module attribute access example raises RecursionError
by Denis Osipov Nov. 6, 2018

Nov. 6, 2018

New submission from Denis Osipov <osipov_d(a)list.ru>: Customizing module attribute access example raises RecursionError: >>> import sys >>> from types import ModuleType >>> class VerboseModule(ModuleType): ... def __repr__(self): ... return f'Verbose {self.__name__}' ... def __setattr__(self, attr, value): ... print(f'Setting {attr}...') ... setattr(self, attr, value) ... >>> sys.modules[__name__].__class__ = VerboseModule >>> sys.modules[__name__].a = 5 Setting a... <...> Setting a... Traceback (most recent call last): File "<stdin>", line 1, in <module> File "<stdin>", line 6, in __setattr__ File "<stdin>", line 6, in __setattr__ File "<stdin>", line 6, in __setattr__ [Previous line repeated 495 more times] File "<stdin>", line 5, in __setattr__ RecursionError: maximum recursion depth exceeded while calling a Python object Setting a...>>> Something like this can fix it: def __setattr__(self, attr, value): ... print(f'Setting {attr}...') ... super().setattr(self, attr, value) ---------- assignee: docs@python components: Documentation messages: 328966 nosy: denis-osipov, docs@python priority: normal severity: normal status: open title: Customizing module attribute access example raises RecursionError type: behavior versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35119> _______________________________________

5 10

[issue22021] shutil.make_archive() root_dir do not work
by Lysandros Nikolaou Nov. 6, 2018

Nov. 6, 2018

Lysandros Nikolaou <lisandrosnik(a)gmail.com> added the comment: Is anybody working on this or can I submit a PR? ---------- nosy: +lys.nikolaou _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22021> _______________________________________

1 0

[issue31793] Allow to specialize smart quotes in documentation translations
by Julien Palard Nov. 5, 2018

Nov. 5, 2018

New submission from Julien Palard <julien+python(a)palard.fr>: It would be great to allow each translation to specify their smart-quotes configuration, typically Japanese prefer no smart-quotes: - https://github.com/python/docsbuild-scripts/issues/32 It's easily done by adding a Doc/docutils.conf file, I'm opening a PR. ---------- assignee: docs@python components: Documentation messages: 304429 nosy: docs@python, mdk priority: normal severity: normal status: open title: Allow to specialize smart quotes in documentation translations versions: Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue31793> _______________________________________

4 10

Documentation bug: Errors and Exceptions
by Andrew Searles Nov. 5, 2018

Nov. 5, 2018

Hi I was reading the tutorial for python when I noticed a typo! I have included the link and section for the page: https://docs.python.org/2/tutorial/errors.html 8.5. User-defined Exceptions *English error:* When creating a module that can raise several distinct errors, a common practice is to create a base class for exceptions defined by that module, and *subclass that to create *specific exception classes for different error conditions: *Possible suggestion:* When creating a module that can raise several distinct errors, a common practice is to create a base class for exceptions defined by that module, and *a subclass to create *specific exception classes for different error conditions: Best, Andrew

1 0

print() separator argument
by Gilberto Agostinho Nov. 5, 2018

Nov. 5, 2018

Hello, This is a very minor report: in the documentation of both Python 3.6 and 3.7, the print() built-in function is said to have a default separator value as sep=' ' in the first line of this function documentation, i.e. ' print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False)'. I believe the correct default argument should be sep=' ', since the default separator adds a space between print()'s arguments -- that is, the default print('foo', 'bar') is equivalent to print('foo', 'bar', sep=' '), both producing 'foo bar', and not equivalent to print('foo', 'bar', sep='') which produces 'foobar'. Links for the pages below: https://docs.python.org/3.6/library/functions.html#print https://docs.python.org/3.7/library/functions.html#print Best, Gilberto Agostinho

1 0

[issue35159] Add a link to the devguide in the sidebar of the documentation
by Stéphane Wirtel Nov. 4, 2018

Nov. 4, 2018

New submission from Stéphane Wirtel <stephane(a)wirtel.be>: I think a link to the devguide could be useful for a future contributor and the right place could be the sidebar in the index page. ---------- assignee: docs@python components: Documentation messages: 329219 nosy: docs@python, matrixise priority: normal severity: normal status: open title: Add a link to the devguide in the sidebar of the documentation _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35159> _______________________________________

2 5

[issue33275] glob.glob should explicitly note that results aren't sorted
by Julien Palard Nov. 4, 2018

Nov. 4, 2018

Change by Julien Palard <julien+python(a)palard.fr>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33275> _______________________________________

1 0