updated readme to reflect caching functionality, and to document other options