[tor-commits] [tor/master] clarify OBSOLETE vs IGNORE.

nickm at torproject.org nickm at torproject.org
Mon Nov 11 16:54:21 UTC 2019


commit 9d562bba40d1e56ba459467611c815ab8d27f27e
Author: Nick Mathewson <nickm at 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.





More information about the tor-commits mailing list