this method should have `.. versionadded:: 1.7` -- an entry in the 1.7 release notes would also be appropriate.