small fixes; polishing
cleanup
a bit more documentation