]> git.ipfire.org Git - thirdparty/tor.git/commitdiff
clarify usage of __ and ___ prefixes on config options
authorNick Mathewson <nickm@torproject.org>
Sat, 24 Aug 2019 21:46:08 +0000 (17:46 -0400)
committerNick Mathewson <nickm@torproject.org>
Sat, 24 Aug 2019 21:46:08 +0000 (17:46 -0400)
src/lib/conf/conftypes.h

index 3b754e07be33f4fe7eaacf5eaacef9764b68ead0..fabad97d0c3c813aad6d6ae95ea034f9e274659d 100644 (file)
@@ -112,12 +112,14 @@ typedef struct struct_magic_decl_t {
 #define CVFLAG_OBSOLETE  (1u<<0)
 /**
  * Flag to indicate that an option is undumpable. An undumpable option is
- * never saved to disk, and is prefixed with __.
+ * never saved to disk. For historical reasons it is prefixed with __ but
+ * not with ___.
  **/
 #define CVFLAG_NODUMP    (1u<<1)
 /**
  * Flag to indicate that an option is "invisible". An invisible option
  * is always undumpable, and we don't tell the controller about it.
+ * For historical reasons it is prefixed with ___.
  **/
 #define CVFLAG_INVISIBLE (1u<<2)