update documentation to match interface change

resolves #1028
Merge pull request #1035 from jdimatteo/master

update documentation to match interface change