clarify documentation for array Allocs