this method needs .. versionadded:: 1.7