[issue29179] Py_UNUSED is not documented
New submission from Petr Viktorin: The Py_UNUSED macro, which was added in Python 3.4, is not documented. Is this an omission, or is it undocumented on purpose? I can prepare a patch if it's the former. The macro was added in: http://bugs.python.org/issue19976 and referenced in: http://bugs.python.org/issue26179 Usage on Github: https://github.com/search?q=py_unused&type=Code ---------- assignee: docs@python components: Documentation messages: 284821 nosy: docs@python, encukou priority: normal severity: normal status: open title: Py_UNUSED is not documented versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue29179> _______________________________________
Changes by Raymond Hettinger <raymond.hettinger@gmail.com>: ---------- assignee: docs@python -> larry nosy: +larry _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue29179> _______________________________________
Petr Viktorin <encukou@gmail.com> added the comment: Since the macro has a public name and is used in the wild outside CPython, I'll go ahead and submit a pull request documenting it. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue29179> _______________________________________
Change by Petr Viktorin <encukou@gmail.com>: ---------- keywords: +patch pull_requests: +4295 stage: -> patch review _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue29179> _______________________________________
STINNER Victor <victor.stinner@gmail.com> added the comment: New changeset 2138163621196a186975796afb2b0a6aa335231d by Victor Stinner (Petr Viktorin) in branch 'master': bpo-29179: Document the Py_UNUSED macro (#4341) https://github.com/python/cpython/commit/2138163621196a186975796afb2b0a6aa33... ---------- nosy: +haypo _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue29179> _______________________________________
Change by STINNER Victor <victor.stinner@gmail.com>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue29179> _______________________________________
STINNER Victor <victor.stinner@gmail.com> added the comment: Thank you Petr for your PR! I merged it. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue29179> _______________________________________
participants (3)
-
Petr Viktorin -
Raymond Hettinger
-
STINNER Victor