clean up, some extra docs, some final val improvements (have to bump version to be on the safe side of binary compat)