Skip to content

Commit d5e9740

Browse files
Update Doc/c-api/set.rst
Co-authored-by: Petr Viktorin <encukou@gmail.com>
1 parent 4d97a04 commit d5e9740

1 file changed

Lines changed: 11 additions & 3 deletions

File tree

Doc/c-api/set.rst

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -173,8 +173,16 @@ Deprecated API
173173
174174
.. c:macro:: PySet_MINSIZE
175175
176-
This is a :term:`soft deprecated` constant representing the size of a
176+
A :term:`soft deprecated` constant representing the size of an internal
177177
preallocated table inside :c:type:`PySetObject` instances.
178178
179-
This is documented solely for completeness and not useful to users in any
180-
way. If looking for the size of a set, use :c:func:`PySet_Size` instead.
179+
This is documented solely for completeness, as there are no guarantees
180+
that a given version of CPython uses preallocated tables with a fixed
181+
size.
182+
In code that does not deal with unstable set internals,
183+
:c:macro:`!PySet_MINSIZE` can be replaced with a small constant like ``8``.
184+
185+
If looking for the size of a set, use :c:func:`PySet_Size` instead.
186+
187+
.. deprecated:: next
188+
The constant is :term:`soft deprecated`.

0 commit comments

Comments
 (0)