Mailman 3 July 2021 - Docs-bugs

[issue44473] logging.handlers.QueueHandler acts unexpected
by Kai Müller July 28, 2021

July 28, 2021

New submission from Kai Müller <kai.jmueller(a)gmail.com>: According to the docstring of logging.handlers.QueueHandler "The base implementation formats the record to merge the message and arguments, and removes unpickleable items from the record in-place." But, if a just a log message is used w/o any arguments, the arguments are still set to None, which IMHO unexpected. Especially, according to the typeshed project, the "args" is ALWAYS either a dict or a tuple. But in this case, they are set to None which surprised my a lot. Would it be possible to improve the docstring to state, that args, exc_info, exc_text are set to None and that msg is overwritten. If you miss this tiny but very important detail, additional handlers can act very wrong. In addition, it seems to be that the type information needs to be improved in typeshed or are there any other plans on your side? ---------- assignee: docs@python components: Documentation messages: 396243 nosy: docs@python, kai.jmueller priority: normal severity: normal status: open title: logging.handlers.QueueHandler acts unexpected type: enhancement versions: Python 3.10, Python 3.11, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44473> _______________________________________

5 6

[issue42167] Documentation for SETUP_WITH opcode is wrong
by Dennis Sweeney July 28, 2021

July 28, 2021

Dennis Sweeney <sweeney.dennis650(a)gmail.com> added the comment: GH-24334 already applied the necessary change for 3.10. ---------- nosy: +iritkatriel _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42167> _______________________________________

1 0

[issue42167] Documentation for SETUP_WITH opcode is wrong
by Dennis Sweeney July 28, 2021

July 28, 2021

Change by Dennis Sweeney <sweeney.dennis650(a)gmail.com>: ---------- keywords: +patch pull_requests: +25935 stage: -> patch review pull_request: https://github.com/python/cpython/pull/27402 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42167> _______________________________________

1 0

[issue42167] Documentation for SETUP_WITH opcode is wrong
by Dennis Sweeney July 28, 2021

July 28, 2021

Dennis Sweeney <sweeney.dennis650(a)gmail.com> added the comment: Opcodes change from one version to another. You linked the Python 3.9 documentation. Python 3.9 opcodes are listed here: https://github.com/python/cpython/blob/3.9/Lib/opcode.py (and you can browse the branches and commit history for that file). 3.9 has SETUP_WITH, but not WITH_CLEANUP_START, so that particular doc entry is all that needs to change (assuming I'm not missing anything), since it wasn't updated during GH-6641. I'll open a PR against the 3.9 docs. ---------- nosy: +Dennis Sweeney _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42167> _______________________________________

1 0

[issue42167] Documentation for SETUP_WITH opcode is wrong
by Patrick Reader July 27, 2021

July 27, 2021

Patrick Reader <pxeger(a)protonmail.com> added the comment: It was, at least partially, replaced by BEGIN_WITH for bpo-40222: https://github.com/python/cpython/commit/adcd2205565f91c6719f4141ab4e1da6d7… ---------- versions: +Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42167> _______________________________________

1 0

[issue42167] Documentation for SETUP_WITH opcode is wrong
by Andrei Kulakov July 27, 2021

July 27, 2021

Andrei Kulakov <andrei.avk(a)gmail.com> added the comment: Note that SETUP_WITH doc was completely removed. Not sure if that was intentional (since the opcode itself still exists). ---------- nosy: +andrei.avk _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42167> _______________________________________

1 0

[issue33896] Document what components make up the filecmp.cmp os.stat signature.
by Andrei Kulakov July 27, 2021

July 27, 2021

Andrei Kulakov <andrei.avk(a)gmail.com> added the comment: Can be closed as a dupe of https://bugs.python.org/issue42958, which has a PR ready for review. ---------- nosy: +andrei.avk _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33896> _______________________________________

1 0

[issue44021] enum docs in 3.10: missing "New in version 3.10"
by Akuli July 27, 2021

July 27, 2021

Change by Akuli <akuviljanen17(a)gmail.com>: ---------- stage: -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44021> _______________________________________

1 0

[issue44021] enum docs in 3.10: missing "New in version 3.10"
by Ken Jin July 27, 2021

July 27, 2021

Ken Jin <kenjin4096(a)gmail.com> added the comment: I think we can close this. The current docs show the version added for the items in OP's list https://docs.python.org/3.11/library/enum.html. Their versionadded should be 3.11 now, but that's a separate issue with a PR at GH-27388. ---------- nosy: +kj _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44021> _______________________________________

1 0

[issue42182] 3.10 Documentation Not Hyperlinking Some Methods
by Andrei Kulakov July 27, 2021

July 27, 2021

Change by Andrei Kulakov <andrei.avk(a)gmail.com>: ---------- keywords: +patch pull_requests: +25917 stage: -> patch review pull_request: https://github.com/python/cpython/pull/27384 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42182> _______________________________________

1 0