Update doc and examples

Update README.md and examples to take latest changes into account, and also add undocumented features.