add note to require api, fixes #1732