Document PriorityQueue.

Add examples to methods.
"This preallocates enough memory for `capacity` elements, so that the `PriorityQueue` does not have to be reallocated until it contains at least that many values."