clarify readme
add/remove files
add doc comments.