diff options
Diffstat (limited to 'kconfiglib.py')
| -rw-r--r-- | kconfiglib.py | 25 |
1 files changed, 23 insertions, 2 deletions
diff --git a/kconfiglib.py b/kconfiglib.py index 1af640e..b6c1d4a 100644 --- a/kconfiglib.py +++ b/kconfiglib.py @@ -3450,8 +3450,29 @@ class Symbol(object): config_string: The .config assignment string that would get written out for the symbol by Kconfig.write_config(). Returns the empty string if no .config - assignment would get written out. In general, visible symbols, symbols - with (active) defaults, and selected symbols get written out. + assignment would get written out. + + In general, visible symbols, symbols with (active) defaults, and selected + symbols get written out. This includes all non-n-valued bool/tristate + symbols, and all visible string/int/hex symbols. + + Symbols with the (no longer needed) 'option env=...' option generate no + configuration output, and neither does the special + 'option defconfig_list' symbol. + + Tip: This field is useful when generating custom configuration output, + even for non-.config-like formats. To write just the symbols that would + get written out to .config files, do this: + + if sym.config_string: + *Write symbol, e.g. by looking sym.str_value* + + This is a superset of the symbols written out by write_autoconf(). + That function skips all n-valued symbols. + + There usually won't be any great harm in just writing all symbols either, + though you might get some special symbols and possibly some "redundant" + n-valued symbol entries in there. nodes: A list of MenuNodes for this symbol. Will contain a single MenuNode for |