add a docstring note about Allocate and the append option