[issue40006] enum: Add documentation for _create_pseudo_member_ and composite members
New submission from Ram Rachum <ram@rachum.com>: Looking at the enum source code, there's a method `_create_pseudo_member_` that's used in a bunch of places. Its docstring says "Create a composite member iff value contains only members", which would have been useful if I had any idea what "composite member" meant. It would be good if the documentation for the enum module would include more information about these two concepts. ---------- assignee: docs@python components: Documentation messages: 364561 nosy: cool-RR, docs@python priority: normal severity: normal status: open title: enum: Add documentation for _create_pseudo_member_ and composite members type: enhancement versions: Python 3.8, Python 3.9 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue40006> _______________________________________
Change by Karthikeyan Singaravelan <tir.karthi@gmail.com>: ---------- nosy: +barry, eli.bendersky, ethan.furman _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue40006> _______________________________________
Change by Ethan Furman <ethan@stoneleaf.us>: ---------- keywords: +patch pull_requests: +24108 stage: -> patch review pull_request: https://github.com/python/cpython/pull/25376 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue40006> _______________________________________
Ethan Furman <ethan@stoneleaf.us> added the comment: `_create_pseudo_member_` was an implementation detail and has been removed. I did update the doc string which was migrated to `_missing_`. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue40006> _______________________________________
Change by Ethan Furman <ethan@stoneleaf.us>: ---------- assignee: docs@python -> ethan.furman resolution: -> fixed stage: patch review -> resolved status: open -> closed versions: +Python 3.10 -Python 3.8, Python 3.9 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue40006> _______________________________________
participants (3)
-
Ethan Furman
-
Karthikeyan Singaravelan
-
Ram Rachum