update api documentation.  fixes #46