doc the core alloc method trouble.