api doc clarification
Merge pull request #395 from willtp87/7.x

api doc clarification