Surfaced by #771's round-two cross-review, and it cannot land until #771 merges.
#771 adds two module-level helpers to pcapkit/corekit/fields/numbers.py — _rebuild_unregistered_member and _reduce_unregistered_member — which together implement the functools.partial-based __reduce_ex__ that keeps an unregistered enum member picklable. Both carry full Args:/Returns: docstrings, but docs/source/pcapkit/corekit/fields/numbers.rst has no stubs for them, so neither is rendered.
docs/source/pcapkit/corekit/fields/numbers.rst was outside the owned file set of the agent that wrote #771, which is why it was left — flagged by that agent rather than missed.
The repo's precedent is individual stubs, not a blanket toggle. :private-members: is commented out repo-wide, and pcapkit/foundation/engines/_pcap_backend.py's _purge — a module-level _-prefixed helper of exactly this shape — is documented with its own .. autofunction::. So the two entries wanted, under the file's existing Internal Definitions heading, are:
.. autofunction:: pcapkit.corekit.fields.numbers._rebuild_unregistered_member
.. autofunction:: pcapkit.corekit.fields.numbers._reduce_unregistered_member
#771 also refers to both helpers in double backticks rather than with :func: roles, deliberately, to avoid a dangling cross-reference while the stubs are absent. Once the stubs exist those prose references can become :func: roles — worth doing in the same change so the two do not drift.
Checkable blocker: #771 merged. The functions do not exist on main until then, so adding the stubs first would break the docs build rather than fix anything. After that this is a docs-only change and goes straight to main.
Surfaced by #771's round-two cross-review, and it cannot land until #771 merges.
#771 adds two module-level helpers to
pcapkit/corekit/fields/numbers.py—_rebuild_unregistered_memberand_reduce_unregistered_member— which together implement thefunctools.partial-based__reduce_ex__that keeps an unregistered enum member picklable. Both carry fullArgs:/Returns:docstrings, butdocs/source/pcapkit/corekit/fields/numbers.rsthas no stubs for them, so neither is rendered.docs/source/pcapkit/corekit/fields/numbers.rstwas outside the owned file set of the agent that wrote #771, which is why it was left — flagged by that agent rather than missed.The repo's precedent is individual stubs, not a blanket toggle.
:private-members:is commented out repo-wide, andpcapkit/foundation/engines/_pcap_backend.py's_purge— a module-level_-prefixed helper of exactly this shape — is documented with its own.. autofunction::. So the two entries wanted, under the file's existing Internal Definitions heading, are:#771 also refers to both helpers in double backticks rather than with
:func:roles, deliberately, to avoid a dangling cross-reference while the stubs are absent. Once the stubs exist those prose references can become:func:roles — worth doing in the same change so the two do not drift.Checkable blocker: #771 merged. The functions do not exist on
mainuntil then, so adding the stubs first would break the docs build rather than fix anything. After that this is a docs-only change and goes straight tomain.