Document PriorityQueue.

Add examples to methods.
Maybe this could have "... in arbitrary order." too?