documented function but not implemented yet