Confgen: link config options to parent choices in the docs

This commit is contained in:
Roland Dobai 2019-04-26 15:43:40 +02:00
parent 30ca5c7a88
commit 254c1c1085

View file

@ -111,13 +111,31 @@ class DeprecatedOptions(object):
f_out.write(line) f_out.write(line)
def append_doc(self, config, path_output): def append_doc(self, config, path_output):
def option_was_written(opt):
return any(gen_kconfig_doc.node_should_write(node) for node in config.syms[opt].nodes)
if len(self.r_dic) > 0: if len(self.r_dic) > 0:
with open(path_output, 'a') as f_o: with open(path_output, 'a') as f_o:
header = 'Deprecated options and their replacements' header = 'Deprecated options and their replacements'
f_o.write('{}\n{}\n\n'.format(header, '-' * len(header))) f_o.write('{}\n{}\n\n'.format(header, '-' * len(header)))
for key in sorted(self.r_dic): for dep_opt in sorted(self.r_dic):
f_o.write('- {}{}: :ref:`{}{}`\n'.format(config.config_prefix, key, new_opt = self.r_dic[dep_opt]
config.config_prefix, self.r_dic[key])) if new_opt not in config.syms or (config.syms[new_opt].choice is None and option_was_written(new_opt)):
# everything except config for a choice (no link reference for those in the docs)
f_o.write('- {}{} (:ref:`{}{}`)\n'.format(config.config_prefix, dep_opt,
config.config_prefix, new_opt))
if new_opt in config.named_choices:
# here are printed config options which were filtered out
syms = config.named_choices[new_opt].syms
for sym in syms:
if sym.name in self.rev_r_dic:
# only if the symbol has been renamed
dep_name = self.rev_r_dic[sym.name]
# config options doesn't have references
f_o.write(' - {}{}\n'.format(config.config_prefix, dep_name))
def append_config(self, config, path_output): def append_config(self, config, path_output):
tmp_list = [] tmp_list = []