since the usage has changed (as of e90de9a), document the new usage and bump the major version