tor

commit 380d3ee1682ce5d202d754d442928710b477f59a
parent 06da2c0d28e41c5a230d96ae8e4f72471bccb5d3
Author: Nick Mathewson <nickm@torproject.org>
Date:   Mon, 26 Aug 2019 19:36:17 -0400

Better explain config_clear_fn_t

Diffstat:
M
src/app/config/confparse.h
 | 
8
+++++++-

1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/src/app/config/confparse.h b/src/app/config/confparse.h
@@ -41,7 +41,13 @@ typedef int (*validate_fn_t)(void*,void*,void*,int,char**);
 
 struct config_mgr_t;
 
-/** Callback to clear all non-managed fields of a configuration object. */
+/**
+ * Callback to clear all non-managed fields of a configuration object.
+ *
+ * (Regular fields get cleared by config_reset(), but you might have fields
+ * in the object that do not correspond to configuration variables.  If those
+ * fields need to be cleared or freed, this is where to do it.)
+ */
 typedef void (*clear_cfg_fn_t)(const struct config_mgr_t *mgr, void*);
 
 /** Information on the keys, value types, key-to-struct-member mappings,