Hash map scaladoc

Scaladoc for HashMap, after comments by Iain McGinn. Also added example code