Issue 2274: Add heapq.heappushpop().
diff --git a/Doc/library/heapq.rst b/Doc/library/heapq.rst
index 115d223..1168fb6 100644
--- a/Doc/library/heapq.rst
+++ b/Doc/library/heapq.rst
@@ -45,6 +45,13 @@
Pop and return the smallest item from the *heap*, maintaining the heap
invariant. If the heap is empty, :exc:`IndexError` is raised.
+.. function:: heappushpop(heap, item)
+
+ Push *item* on the heap, then pop and return the smallest item from the
+ *heap*. The combined action runs more efficiently than :func:`heappush`
+ followed by a separate call to :func:`heappop`.
+
+ .. versionadded:: 2.6
.. function:: heapify(x)