document the options available to Allocate