Updates to Allocator documentation

Added description, corrected API name.

Modified: README.md