diff --git a/adoc/chapters/programming_interface.adoc b/adoc/chapters/programming_interface.adoc index 2332823d..3719f77c 100644 --- a/adoc/chapters/programming_interface.adoc +++ b/adoc/chapters/programming_interface.adoc @@ -4889,11 +4889,9 @@ can supply their own allocator class. } ---- -When an allocator returns a [code]#nullptr#, the runtime cannot allocate data on -the host. -Note that in this case the runtime will raise an error if it requires host -memory but it is not available (e.g when moving data across <> -contexts). +Note that if the runtime requires host memory (e.g., when moving data across +<> contexts), but the allocator fails to allocate the memory, then the +runtime will raise an error. In some cases, the implementation may retain a copy of the allocator object even after the buffer is destroyed. @@ -4918,8 +4916,6 @@ STL-based libraries (e.g, Intel's TBB provides an allocator). ==== Default allocators A default allocator is always defined by the implementation. -For allocations greater than size zero, when successful it is guaranteed to -return non-[code]#nullptr# and new memory positions every call. The default allocator for const buffers will remove the const-ness of the type (therefore, the default allocator for a buffer of type [code]#const int# will be an [code]#Allocator)#.