summaryrefslogtreecommitdiffstats
path: root/Doc/lib
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/lib')
-rw-r--r--Doc/lib/libheapq.tex6
1 files changed, 5 insertions, 1 deletions
diff --git a/Doc/lib/libheapq.tex b/Doc/lib/libheapq.tex
index ffcafcd..edacf79 100644
--- a/Doc/lib/libheapq.tex
+++ b/Doc/lib/libheapq.tex
@@ -59,7 +59,11 @@ If the heap is empty, \exception{IndexError} is raised.
This is more efficient than \function{heappop()} followed
by \function{heappush()}, and can be more appropriate when using
a fixed-size heap. Note that the value returned may be larger
-than \var{item}! That constrains reasonable uses of this routine.
+than \var{item}! That constrains reasonable uses of this routine
+unless written as part of a larger expression:
+\begin{verbatim}
+ result = item <= heap[0] and item or heapreplace(heap, item)
+\end{verbatim}
\end{funcdesc}
Example of use: