README and examples updated