some of the Scala style guide just offends my eyes
some style fixup and some docs 
use multiline comments (such a novelty coming from perl)
I feel like the match/case reads better then the map.getOrElse, so replacing that for now