svn commit: samba r4793 - in branches/SAMBA_4_0/source/lib/talloc: .

tridge at samba.org tridge at samba.org
Mon Jan 17 02:52:10 GMT 2005


Author: tridge
Date: 2005-01-17 02:52:10 +0000 (Mon, 17 Jan 2005)
New Revision: 4793

WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba&rev=4793

Log:
minor doc updates


Modified:
   branches/SAMBA_4_0/source/lib/talloc/talloc_guide.txt


Changeset:
Modified: branches/SAMBA_4_0/source/lib/talloc/talloc_guide.txt
===================================================================
--- branches/SAMBA_4_0/source/lib/talloc/talloc_guide.txt	2005-01-16 23:32:37 UTC (rev 4792)
+++ branches/SAMBA_4_0/source/lib/talloc/talloc_guide.txt	2005-01-17 02:52:10 UTC (rev 4793)
@@ -32,10 +32,9 @@
 n-ary tree, where you can free any part of the tree with
 talloc_free().
 
-If you find this confusing, then I suggest you run the LOCAL-TALLOC
-smbtorture test to watch talloc in action. You may also like to add
-your own tests to source/lib/talloc/testsuite.c to clarify how some
-particular situation is handled.
+If you find this confusing, then I suggest you run the testsuite to
+watch talloc in action. You may also like to add your own tests to
+testsuite.c to clarify how some particular situation is handled.
 
 
 Performance
@@ -74,6 +73,7 @@
 The context argument to talloc() can be NULL, in which case a new top
 level context is created. 
 
+
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
 void *talloc_size(const void *context, size_t size);
 
@@ -81,13 +81,7 @@
 convenient type to pass to talloc(). Unlike talloc(), it is not type
 safe (as it returns a void *), so you are on your own for type checking.
 
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-void *talloc_p(const void *context, type);
 
-talloc_p() is a alias for talloc(). It only exists as a backwards
-compatibity macro for code from the bad old days when talloc() was not
-type safe.
-
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
 int talloc_free(void *ptr);
 
@@ -491,10 +485,13 @@
 except that it provides integer overflow protection for the multiply,
 returning NULL if the multiply overflows.
 
+
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
 void *talloc_array_size(const void *ctx, size_t size, uint_t count);
 
-The talloc_array_size() function is useful when the type is not known
+The talloc_array_size() function is useful when the type is not
+known. It operates in the same way as talloc_array(), but takes a size
+instead of a type.
 
 
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
@@ -506,6 +503,7 @@
 realloc() in one call, which is why it is useful to be able to pass
 around a single function pointer.
 
+
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
 void *talloc_autofree_context(void);
 
@@ -540,7 +538,3 @@
 
 It is equivalent to this:
    talloc_set_name_const(ptr, #type)
-
-
-
-



More information about the samba-cvs mailing list