Docs for method signature changes.
Merge pull request #1253 from dereuromark/3.0-api

3.0 api