revise readme and comment text within several source modules