This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Py_UNUSED is not documented
Type: Stage: resolved
Components: Documentation Versions: Python 3.7, Python 3.6, Python 3.4, Python 3.5
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: larry Nosy List: docs@python, larry, petr.viktorin, vstinner
Priority: normal Keywords: patch

Created on 2017-01-06 14:28 by petr.viktorin, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 4341 merged petr.viktorin, 2017-11-08 15:51
Messages (4)
msg284821 - (view) Author: Petr Viktorin (petr.viktorin) * (Python committer) Date: 2017-01-06 14:28
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
msg305861 - (view) Author: Petr Viktorin (petr.viktorin) * (Python committer) Date: 2017-11-08 15:51
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.
msg305866 - (view) Author: STINNER Victor (vstinner) * (Python committer) Date: 2017-11-08 15:59
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/2138163621196a186975796afb2b0a6aa335231d
msg305868 - (view) Author: STINNER Victor (vstinner) * (Python committer) Date: 2017-11-08 16:00
Thank you Petr for your PR! I merged it.
History
Date User Action Args
2022-04-11 14:58:41adminsetgithub: 73365
2017-11-08 16:00:04vstinnersetmessages: + msg305868
2017-11-08 15:59:50vstinnersetstatus: open -> closed
resolution: fixed
stage: patch review -> resolved
2017-11-08 15:59:23vstinnersetnosy: + vstinner
messages: + msg305866
2017-11-08 15:51:37petr.viktorinsetkeywords: + patch
stage: patch review
pull_requests: + pull_request4295
2017-11-08 15:51:21petr.viktorinsetmessages: + msg305861
2017-01-07 00:35:17rhettingersetassignee: docs@python -> larry

nosy: + larry
2017-01-06 14:28:56petr.viktorincreate