X-Git-Url: http://git.ozlabs.org/?a=blobdiff_plain;f=ccan%2Ftdb2%2Ftdb2.h;fp=ccan%2Ftdb2%2Ftdb2.h;h=d9194a5eccce54629595966d277cefa0cb7cf8c5;hb=8cca0397ef6f6017b13ce9ab4999bf3d92a2dee5;hp=296410e74196573a955470b78c422daa870f8be5;hpb=66ead2bcb732aa53bde5092b34c16d780df779ea;p=ccan

diff --git a/ccan/tdb2/tdb2.h b/ccan/tdb2/tdb2.h
index 296410e7..d9194a5e 100644
--- a/ccan/tdb2/tdb2.h
+++ b/ccan/tdb2/tdb2.h
@@ -729,13 +729,13 @@ struct tdb_attribute_seed {
  * struct tdb_attribute_stats - tdb operational statistics
  *
  * This attribute records statistics of various low-level TDB operations.
- * This can be used to assist performance evaluation.
+ * This can be used to assist performance evaluation.  This is only
+ * useful for tdb_get_attribute().
  *
  * New fields will be added at the end, hence the "size" argument which
- * indicates how large your structure is.  If your size is larger than
- * that known about by this version of tdb, the size will be reduced to
- * the known structure size.  Thus you can detect older versions, and
- * thus know that newer stats will not be updated.
+ * indicates how large your structure is: it must be filled in before
+ * calling tdb_get_attribute(), which will overwrite it with the size
+ * tdb knows about.
  */
 struct tdb_attribute_stats {
 	struct tdb_attribute_base base; /* .attr = TDB_ATTRIBUTE_STATS */