Fill in example code for HashMap.

Add an example showing how to use the map with a custom type. Fill in
examples for methods  without ones.

Also move `pop_equiv` next to related public methods, to not create a
duplicate trait in the docs.
I think the forward looking " but this will ..." part of the sentence can be removed.