Make readable ScalaDoc of core

Fixes #165
Merge pull request #166 from rightfold/master

Make ScalaDoc readable