Document PriorityQueue.

Add examples to methods.
May want to mention what a 'capacity' is and why you'd make a queue with one?

"An empty queue with a capacity pre-allocates memory to fit the capacity, so that you're not allocating all the time" or whatever. That sample started off strong and then got bad :)