documented latest functionality