- <para>
- <classname>GstMemory</classname> objects are created by a
- <classname>GstAllocator</classname> object. To implement support
- for a new kind of memory type, you must implement a new allocator
- object.
- </para>
+ <sect2 id="section-allocation-allocator" xreflabel="GstAllocator">
+ <title>GstAllocator</title>
+ <para>
+ <classname>GstMemory</classname> objects are created by a
+ <classname>GstAllocator</classname> object. Most allocators implement the
+ default <function>gst_allocator_alloc()</function> method but some allocator
+ might implement a different method, for example when additional parameters
+ are needed to allocate the specific memory.
+ </para>
+ <para>
+ Different allocators exist for, for example, system memory, shared memory
+ and memory backed by a DMAbuf file descriptor. To implement support for a
+ new kind of memory type, you must implement a new allocator object as shown
+ below.
+ </para>
+ </sect2>