minor api changes. added examples