fixes/clarfication for hashes

I am happy to contribute here, with so many years spent in Perl and getting better and better in Scala