updating comments for caching usage; minor spacing fixes