added examples and a couple of tweaks