r5939: improve talloc_realloc() docs after feedback from lifeless
authorAndrew Tridgell <tridge@samba.org>
Tue, 22 Mar 2005 06:00:51 +0000 (06:00 +0000)
committerGerald (Jerry) Carter <jerry@samba.org>
Wed, 10 Oct 2007 18:11:10 +0000 (13:11 -0500)
(This used to be commit 301cbb0d12919f83d6b735c2e23b49fb49d5394d)

source4/lib/talloc/talloc_guide.txt

index eae6c5e56477eed642b350e1bab93648659d846a..4ab0f8eacc3c70a46ae6ee11978ebe4f76fc4110 100644 (file)
@@ -267,9 +267,13 @@ particularly useful for creating a new temporary working context.
 (type *)talloc_realloc(const void *context, void *ptr, type, count);
 
 The talloc_realloc() macro changes the size of a talloc
-pointer. It has the following equivalences:
+pointer. The "count" argument is the number of elements of type "type"
+that you want the resulting pointer to hold. 
+
+talloc_realloc() has the following equivalences:
 
   talloc_realloc(context, NULL, type, 1) ==> talloc(context, type);
+  talloc_realloc(context, NULL, type, N) ==> talloc_array(context, type, N);
   talloc_realloc(context, ptr, type, 0)  ==> talloc_free(ptr);
 
 The "context" argument is only used if "ptr" is not NULL, otherwise it