documenting another alternative
making emacs checkdoc happy
since the usage has changed (as of e90de9a), document the new usage and bump the major version