[issue32142] heapq.heappop - documentation misleading or doesn't work

2017-11-26 Thread Scott Queen
Scott Queen <scoote...@gmail.com> added the comment: Fair statement. "Properly sorted" was a poor choice. Seems that "if the invariant is true as a precondition, it will be true as a postcondition" is accurate and descriptive - maybe with a caution that modifying the l

[issue32142] heapq.heappop - documentation misleading or doesn't work

2017-11-26 Thread Scott Queen
New submission from Scott Queen <scoote...@gmail.com>: The documentation for heapq.heappop(heap) says: "Pop and return the smallest item from the heap, maintaining the heap invariant. If the heap is empty, IndexError is raised. To access the smallest item without popping it, use hea