#11: more cleanup of code and scaladoc
increment version to 1.2.1
#11: fix minor bugs, update CLI documentation