needs `.. versionadded:: 1.7`