update api docs for change made in issue #328