more docs on fields
alloc only when unallocated