Talloc doc: talloc_pool() when not enough memory in the pool

diff --git a/lib/talloc/talloc.h b/lib/talloc/talloc.h
index 09a2b81768e5170e03611b6fbb5efa9cceb61547..5d905073b43ff0c24f8d83d99f6c13833bb57790 100644 (file)
--- a/lib/talloc/talloc.h
+++ b/lib/talloc/talloc.h
@@ -827,6 +827,10 @@ void *talloc_find_parent_bytype(const void *ptr, #type);
  * recursively. If you use the child of the talloc pool as a parent for
  * grand-children, their memory is also taken from the talloc pool.
  *
+ * If there is not enough memory in the pool to allocate the new child,
+ * it will create a new talloc chunk as if the parent was a normal talloc
+ * context.
+ *
  * If you talloc_free() children of a talloc pool, the memory is not given
  * back to the system. Instead, free(3) is only called if the talloc_pool()
  * itself is released with talloc_free().