We can't actually deprecate the function, because it is also used for arrays and vectors, so we can only document this.