From 59dff5745528a3efe585cdeb03e2bedd6b2e404a Mon Sep 17 00:00:00 2001
From: Volker Lendecke <vl@samba.org>
Date: Sat, 21 Mar 2009 23:57:14 +0100
Subject: Document talloc_zero_array()

---
 lib/talloc/talloc.h | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/lib/talloc/talloc.h b/lib/talloc/talloc.h
index 9806bdd3ad..ae488baf32 100644
--- a/lib/talloc/talloc.h
+++ b/lib/talloc/talloc.h
@@ -426,6 +426,22 @@ typedef void TALLOC_CTX;
 
 #define talloc_zero_size(ctx, size) _talloc_zero(ctx, size, __location__)
 
+/**
+ * \def talloc_zero_array(ctx, type, count)
+ * \brief Allocate a 0-initialized array
+ * \param ctx The talloc context to hang the result off
+ * \param type The type that we want to allocate
+ * \param count The number of "type" elements you want to allocate
+ * \return The allocated result, properly cast to "type *"
+ * \ingroup talloc_array
+ *
+ * The talloc_zero_array() macro is equivalent to:
+ *
+ * \code
+ * ptr = talloc_array(ctx, type, count);
+ * if (ptr) memset(ptr, sizeof(type) * count);
+ * \endcode
+ */
 #define talloc_zero_array(ctx, type, count) (type *)_talloc_zero_array(ctx, sizeof(type), count, #type)
 
 /**
-- 
cgit