Api2

Document that this function makes a copy iff you don't give it a pointer.