correct the document
use passive voice to conform to all existing states
use alias func for preserving backward compat