Confusing documentation for the `n` parameter of `Threading.Condition.notify(n)`

Documentation

I'm confused by this documentation of Threading.Condition.notify(), specifically the n parameter.

[...]

This method wakes up at most n of the threads waiting for the condition variable; it is a no-op if no threads are waiting.

The current implementation wakes up exactly n threads, if at least n threads are waiting. However, it’s not safe to rely on this behavior. A future, optimized implementation may occasionally wake up more than n threads.

[...]

(Boldface added by me.)

So is the contract that it will wake up ≤n threads, or ≥n threads? Is there any guarantee at all?

Commencez par la documentation liée de Python 3.12 concernant threading.Condition.notify() et lisez la description complète du paramètre n. Clarifiez la relation entre la limite indiquée et l’implémentation actuelle, notamment pour déterminer si une quelconque garantie est prévue ; le travail est terminé lorsque la documentation ne laisse plus le contrat ambigu.