improve help messages and fix README