various clarifications to readme