xenia/kakoune
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve readability of command docstrings by changing formatting

Browse Source 
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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
src/command_manager.cc
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;
}

2
src/commands.cc
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)

2
src/parameters_parser.cc
View File

@ -9,7 +9,7 @@ String generate_switches_doc(const SwitchMap& switches)
{
String res;
for (auto& sw : switches)
res += format(" -{} {}: {}\n", sw.key,
res += format("-{} {}: {}\n", sw.key,
sw.value.takes_arg ? "<arg>" : "",
sw.value.description);
return res;