commit 9d562bba40d1e56ba459467611c815ab8d27f27e Author: Nick Mathewson <nickm@torproject.org> Date: Mon Nov 11 11:54:02 2019 -0500 clarify OBSOLETE vs IGNORE. --- src/lib/conf/conftypes.h | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/src/lib/conf/conftypes.h b/src/lib/conf/conftypes.h index ea1c8d476..19ea99731 100644 --- a/src/lib/conf/conftypes.h +++ b/src/lib/conf/conftypes.h @@ -64,8 +64,18 @@ typedef enum config_type_t { CONFIG_TYPE_LINELIST_V, /**< Catch-all "virtual" option to summarize * context-sensitive config lines when fetching. */ - CONFIG_TYPE_OBSOLETE, /**< Ignored (obsolete) option. Uses no storage. */ - CONFIG_TYPE_IGNORE, /**< Ignored option. Uses no storage. */ + /** Ignored (obsolete) option. Uses no storage. + * + * Reported as "obsolete" when its type is queried. + */ + CONFIG_TYPE_OBSOLETE, + /** Ignored option. Uses no storage. + * + * Reported as "ignored" when its type is queried. For use with options used + * by disabled modules. + **/ + CONFIG_TYPE_IGNORE, + /** * Extended type: definition appears in the <b>type_def</b> pointer * of the corresponding struct_member_t.