improve README and usage information in code