+ docs in xo-alloc2/ + misc improvements

2025-12-11 22:18:09 -05:00 · 2025-12-11 22:18:09 -05:00 · f52184f84c
commit f52184f84c
parent c172492007
29 changed files with 868 additions and 178 deletions
--- a/xo-alloc2/docs/implementation.rst
+++ b/xo-alloc2/docs/implementation.rst
@ -0,0 +1,51 @@
+.. _implementation:
+
+Components
+==========
+
+Library dependency tower for *xo-alloc2*
+
+.. ditaa::
+
+    +-----------------+
+    |    xo_alloc2    |
+    +-----------------+
+    |    xo_facet     |
+    +-----------------+
+    |    xo_cmake     |
+    +-----------------+
+
+Abstraction tower for *xo-alloc2* components
+
+.. ditaa::
+    :--scale: 0.99
+
+    +--------------------------------+
+    |      IAllocator_DArena         |
+    +--------------------------------+
+    |      IAllocator_Xfer           |
+    +--------------------------------+
+    |      IAllocator_ImplType       |
+    +--------------+-----------------+
+    |              |    DArena       |
+    |  AAllocator  +-----------------+
+    |              | ArenaConfig     |
+    +--------------+-----------------+
+
+.. list-table:: Descriptions
+    :header-rows: 1
+    :widths: 20 90
+
+    * - Component
+      - Description
+    * - ``AAllocator``
+      - allocator facet (abstract interface)
+    * - ``DArena``
+      - arena representation
+    * - ``IAllocator_ImplType<D>``
+      - lookup implementation for allocator A
+        with representation D.
+    * - ``IAllocator_Xfer<D>``
+      - transfer interface. downcast to native state.
+    * - ``IAllocator_DArena``
+      - allocator implementation for ``DArena``