some minor tweaks
fix a few errors and add some examples