Updating docs and example files to match the API.

I struggled with this last night, then realized the docs are incorrect vs how the API works.  There's an open issue for this (issue #95) as well.