On Tue, 20 Nov 2018 10:05:21 +0100 Vlastimil Babka <vbabka@xxxxxxx> wrote: > Why can't the documentation describe the current implementation, and > change in the future if the implementation changes? I doubt somebody > would ever rely on the pid being reused while having the descriptor > open. How would that make sense? In the hopes of ending this discussion, I'm going to go ahead and apply this. Documenting current behavior is good, especially in situations where that behavior can surprise people; if the implementation changes, the docs can change with it. Thanks, jon