Improve readability of command docstrings by changing formatting

Fixes #1378
This commit is contained in:
Maxime Coste 2017-06-04 08:37:51 +01:00
parent 6101138606
commit 261e0fabcc
3 changed files with 5 additions and 12 deletions

View File

@ -538,26 +538,19 @@ Optional<CommandInfo> CommandManager::command_info(const Context& context, Strin
}
String helpstr = cmd->value.helper(context, params);
if (not helpstr.empty())
{
if (helpstr.back() != '\n')
helpstr += '\n';
res.info += helpstr;
}
res.info += format("{}\n", helpstr);
}
String aliases;
for (auto& alias : context.aliases().aliases_for(cmd->key))
aliases += " " + alias;
if (not aliases.empty())
res.info += "Aliases:" + aliases + "\n";
res.info += format("Aliases:{}\n", aliases);
auto& switches = cmd->value.param_desc.switches;
if (not switches.empty())
{
res.info += "Switches:\n";
res.info += generate_switches_doc(switches);
}
res.info += format("Switches:\n{}", indent(generate_switches_doc(switches)));
return res;
}

View File

@ -1222,7 +1222,7 @@ static String option_doc_helper(const Context& context, CommandParameters params
if (not desc or desc->docstring().empty())
return "";
return format("{}: {}", desc->name(), desc->docstring());
return format("{}:\n{}", desc->name(), indent(desc->docstring()));
}
static OptionManager& get_options(StringView scope, const Context& context, StringView option_name)