mirror of https://github.com/tstack/lnav.git
625 lines
22 KiB
C++
625 lines
22 KiB
C++
/**
|
|
* Copyright (c) 2017, Timothy Stack
|
|
*
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* * Redistributions of source code must retain the above copyright notice, this
|
|
* list of conditions and the following disclaimer.
|
|
* * Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
* * Neither the name of Timothy Stack nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ''AS IS'' AND ANY
|
|
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY
|
|
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
|
|
* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include <algorithm>
|
|
#include <regex>
|
|
|
|
#include "base/string_util.hh"
|
|
#include "fmt/format.h"
|
|
#include "ansi_scrubber.hh"
|
|
#include "help_text_formatter.hh"
|
|
#include "readline_highlighters.hh"
|
|
|
|
using namespace std;
|
|
|
|
|
|
std::multimap<std::string, help_text *> help_text::TAGGED;
|
|
|
|
static vector<help_text *> get_related(const help_text &ht)
|
|
{
|
|
vector<help_text *> retval;
|
|
|
|
for (const auto &tag : ht.ht_tags) {
|
|
auto tagged = help_text::TAGGED.equal_range(tag);
|
|
|
|
for (auto tag_iter = tagged.first;
|
|
tag_iter != tagged.second;
|
|
++tag_iter) {
|
|
if (tag_iter->second == &ht) {
|
|
continue;
|
|
}
|
|
|
|
help_text &related = *tag_iter->second;
|
|
|
|
if (!related.ht_opposites.empty() &&
|
|
find_if(related.ht_opposites.begin(),
|
|
related.ht_opposites.end(),
|
|
[&ht](const char *x) {
|
|
return strcmp(x, ht.ht_name) == 0;
|
|
}) == related.ht_opposites.end()) {
|
|
continue;
|
|
}
|
|
|
|
retval.push_back(&related);
|
|
|
|
}
|
|
}
|
|
|
|
return retval;
|
|
}
|
|
|
|
void format_help_text_for_term(const help_text &ht, size_t width, attr_line_t &out, bool synopsis_only)
|
|
{
|
|
static const size_t body_indent = 2;
|
|
|
|
view_colors &vc = view_colors::singleton();
|
|
text_wrap_settings tws;
|
|
size_t start_index = out.get_string().length();
|
|
|
|
tws.with_width(width);
|
|
|
|
switch (ht.ht_context) {
|
|
case help_context_t::HC_COMMAND: {
|
|
out.append("Synopsis", &view_curses::VC_STYLE, A_UNDERLINE)
|
|
.append("\n")
|
|
.append(body_indent, ' ')
|
|
.append(":")
|
|
.append(ht.ht_name, &view_curses::VC_STYLE, A_BOLD);
|
|
for (auto ¶m : ht.ht_parameters) {
|
|
out.append(" ");
|
|
if (param.ht_nargs == help_nargs_t::HN_OPTIONAL) {
|
|
out.append("[");
|
|
}
|
|
out.append(param.ht_name, &view_curses::VC_STYLE, A_UNDERLINE);
|
|
if (param.ht_nargs == help_nargs_t::HN_OPTIONAL) {
|
|
out.append("]");
|
|
}
|
|
if (param.ht_nargs == help_nargs_t::HN_ONE_OR_MORE) {
|
|
out.append("1", &view_curses::VC_STYLE, A_UNDERLINE);
|
|
out.append(" [");
|
|
out.append("...", &view_curses::VC_STYLE, A_UNDERLINE);
|
|
out.append(" ");
|
|
out.append(param.ht_name, &view_curses::VC_STYLE,
|
|
A_UNDERLINE);
|
|
out.append("N", &view_curses::VC_STYLE, A_UNDERLINE);
|
|
out.append("]");
|
|
}
|
|
}
|
|
out.append(" - ")
|
|
.append(attr_line_t::from_ansi_str(ht.ht_summary),
|
|
&tws.with_indent(body_indent + 2))
|
|
.append("\n");
|
|
break;
|
|
}
|
|
case help_context_t::HC_SQL_FUNCTION:
|
|
case help_context_t::HC_SQL_TABLE_VALUED_FUNCTION: {
|
|
size_t line_start = body_indent;
|
|
bool break_all = false;
|
|
bool needs_comma = false;
|
|
|
|
if (!synopsis_only) {
|
|
out.append("Synopsis", &view_curses::VC_STYLE, A_UNDERLINE)
|
|
.append("\n");
|
|
}
|
|
|
|
line_start = out.length();
|
|
out.append(body_indent, ' ')
|
|
.append(ht.ht_name, &view_curses::VC_STYLE, A_BOLD)
|
|
.append("(");
|
|
for (auto ¶m : ht.ht_parameters) {
|
|
if (!param.ht_flag_name && needs_comma) {
|
|
out.append(", ");
|
|
}
|
|
if (break_all ||
|
|
(int)(out.get_string().length() - line_start + 10) >=
|
|
tws.tws_width) {
|
|
out.append("\n");
|
|
line_start = out.get_string().length();
|
|
out.append(body_indent + strlen(ht.ht_name) + 1, ' ');
|
|
break_all = true;
|
|
}
|
|
if (param.ht_flag_name) {
|
|
out.append(" ")
|
|
.append(param.ht_flag_name, &view_curses::VC_STYLE, A_BOLD)
|
|
.append(" ");
|
|
}
|
|
if (param.ht_nargs == help_nargs_t::HN_OPTIONAL) {
|
|
out.append("[");
|
|
}
|
|
out.append(param.ht_name, &view_curses::VC_STYLE, A_UNDERLINE);
|
|
if (param.ht_nargs == help_nargs_t::HN_OPTIONAL) {
|
|
out.append("]");
|
|
}
|
|
if (param.ht_nargs == help_nargs_t::HN_ZERO_OR_MORE ||
|
|
param.ht_nargs == help_nargs_t::HN_ONE_OR_MORE) {
|
|
out.append(", ...");
|
|
}
|
|
needs_comma = true;
|
|
}
|
|
out.append(") -- ");
|
|
if (break_all) {
|
|
out.append("\n")
|
|
.append(body_indent + strlen(ht.ht_name) + 1, ' ');
|
|
}
|
|
out.append(attr_line_t::from_ansi_str(ht.ht_summary),
|
|
&tws.with_indent(body_indent + 2))
|
|
.append("\n");
|
|
break;
|
|
}
|
|
case help_context_t::HC_SQL_INFIX:
|
|
case help_context_t::HC_SQL_KEYWORD: {
|
|
size_t line_start = body_indent;
|
|
bool break_all = false;
|
|
bool is_infix = ht.ht_context == help_context_t::HC_SQL_INFIX;
|
|
|
|
if (!synopsis_only) {
|
|
out.append("Synopsis", &view_curses::VC_STYLE, A_UNDERLINE)
|
|
.append("\n");
|
|
}
|
|
out.append(body_indent, ' ')
|
|
.append(ht.ht_name,
|
|
&view_curses::VC_STYLE,
|
|
is_infix ? 0 : A_BOLD);
|
|
for (auto ¶m : ht.ht_parameters) {
|
|
if (break_all ||
|
|
(int)(out.get_string().length() - start_index - line_start + 10) >=
|
|
tws.tws_width) {
|
|
out.append("\n");
|
|
line_start = out.get_string().length();
|
|
out.append(body_indent + strlen(ht.ht_name) + 1, ' ');
|
|
break_all = true;
|
|
}
|
|
if (param.ht_nargs == help_nargs_t::HN_ZERO_OR_MORE ||
|
|
param.ht_nargs == help_nargs_t::HN_OPTIONAL) {
|
|
if (!break_all) {
|
|
out.append(" ");
|
|
}
|
|
out.append("[");
|
|
}
|
|
if (param.ht_flag_name) {
|
|
out.ensure_space()
|
|
.append(param.ht_flag_name, &view_curses::VC_STYLE,
|
|
A_BOLD);
|
|
}
|
|
if (param.ht_group_start) {
|
|
out.ensure_space()
|
|
.append(param.ht_group_start, &view_curses::VC_STYLE,
|
|
A_BOLD);
|
|
}
|
|
if (param.ht_name[0]) {
|
|
out.ensure_space()
|
|
.append(param.ht_name, &view_curses::VC_STYLE,
|
|
A_UNDERLINE);
|
|
if (!param.ht_parameters.empty()) {
|
|
if (param.ht_nargs == help_nargs_t::HN_ZERO_OR_MORE ||
|
|
param.ht_nargs == help_nargs_t::HN_ONE_OR_MORE) {
|
|
out.append("1", &view_curses::VC_STYLE, A_UNDERLINE);
|
|
}
|
|
if (param.ht_parameters[0].ht_flag_name) {
|
|
out.append(" ")
|
|
.append(param.ht_parameters[0].ht_flag_name,
|
|
&view_curses::VC_STYLE,
|
|
A_BOLD)
|
|
.append(" ");
|
|
}
|
|
out.append(param.ht_parameters[0].ht_name,
|
|
&view_curses::VC_STYLE,
|
|
A_UNDERLINE);
|
|
}
|
|
}
|
|
if (param.ht_nargs == help_nargs_t::HN_ZERO_OR_MORE ||
|
|
param.ht_nargs == help_nargs_t::HN_ONE_OR_MORE) {
|
|
bool needs_comma = param.ht_parameters.empty() ||
|
|
!param.ht_flag_name;
|
|
|
|
out.append("1", &view_curses::VC_STYLE, A_UNDERLINE)
|
|
.append(" [")
|
|
.append(needs_comma ? ", " : "")
|
|
.append("...")
|
|
.append(needs_comma ? "" : " ")
|
|
.append((needs_comma || !param.ht_flag_name) ? "" : param.ht_flag_name,
|
|
&view_curses::VC_STYLE,
|
|
A_BOLD)
|
|
.append(" ")
|
|
.append(param.ht_name, &view_curses::VC_STYLE,
|
|
A_UNDERLINE)
|
|
.append("N", &view_curses::VC_STYLE, A_UNDERLINE);
|
|
if (!param.ht_parameters.empty()) {
|
|
if (param.ht_parameters[0].ht_flag_name) {
|
|
out.append(" ")
|
|
.append(param.ht_parameters[0].ht_flag_name,
|
|
&view_curses::VC_STYLE,
|
|
A_BOLD)
|
|
.append(" ");
|
|
}
|
|
|
|
out.append(param.ht_parameters[0].ht_name,
|
|
&view_curses::VC_STYLE,
|
|
A_UNDERLINE)
|
|
.append("N", &view_curses::VC_STYLE, A_UNDERLINE);
|
|
}
|
|
out.append("]");
|
|
}
|
|
if (param.ht_group_end) {
|
|
out.ensure_space()
|
|
.append(param.ht_group_end, &view_curses::VC_STYLE,
|
|
A_BOLD);
|
|
}
|
|
if (param.ht_nargs == help_nargs_t::HN_ZERO_OR_MORE ||
|
|
param.ht_nargs == help_nargs_t::HN_OPTIONAL) {
|
|
out.append("]");
|
|
}
|
|
}
|
|
if (!synopsis_only) {
|
|
out.append("\n\n")
|
|
.append(body_indent, ' ')
|
|
.append(ht.ht_summary, &tws)
|
|
.append("\n");
|
|
} else {
|
|
out.append("\n");
|
|
}
|
|
break;
|
|
}
|
|
default:
|
|
break;
|
|
}
|
|
|
|
if (!synopsis_only && !ht.ht_parameters.empty()) {
|
|
size_t max_param_name_width = 0;
|
|
|
|
for (auto ¶m : ht.ht_parameters) {
|
|
max_param_name_width = std::max(strlen(param.ht_name),
|
|
max_param_name_width);
|
|
}
|
|
|
|
out.append(ht.ht_parameters.size() == 1 ? "Parameter" : "Parameters",
|
|
&view_curses::VC_STYLE,
|
|
A_UNDERLINE)
|
|
.append("\n");
|
|
|
|
for (auto ¶m : ht.ht_parameters) {
|
|
if (!param.ht_summary) {
|
|
continue;
|
|
}
|
|
|
|
out.append(body_indent, ' ')
|
|
.append(param.ht_name,
|
|
&view_curses::VC_STYLE,
|
|
vc.attrs_for_role(view_colors::VCR_VARIABLE) | A_BOLD)
|
|
.append(max_param_name_width - strlen(param.ht_name), ' ')
|
|
.append(" ")
|
|
.append(attr_line_t::from_ansi_str(param.ht_summary),
|
|
&(tws.with_indent(2 + max_param_name_width + 3)))
|
|
.append("\n");
|
|
}
|
|
}
|
|
if (!synopsis_only && !ht.ht_results.empty()) {
|
|
size_t max_result_name_width = 0;
|
|
|
|
for (auto &result : ht.ht_results) {
|
|
max_result_name_width = std::max(strlen(result.ht_name),
|
|
max_result_name_width);
|
|
}
|
|
|
|
out.append(ht.ht_results.size() == 1 ? "Result" : "Results",
|
|
&view_curses::VC_STYLE,
|
|
A_UNDERLINE)
|
|
.append("\n");
|
|
|
|
for (auto &result : ht.ht_results) {
|
|
if (!result.ht_summary) {
|
|
continue;
|
|
}
|
|
|
|
out.append(body_indent, ' ')
|
|
.append(result.ht_name,
|
|
&view_curses::VC_STYLE,
|
|
vc.attrs_for_role(view_colors::VCR_VARIABLE) | A_BOLD)
|
|
.append(max_result_name_width - strlen(result.ht_name), ' ')
|
|
.append(" ")
|
|
.append(attr_line_t::from_ansi_str(result.ht_summary),
|
|
&(tws.with_indent(2 + max_result_name_width + 3)))
|
|
.append("\n");
|
|
}
|
|
}
|
|
if (!synopsis_only && !ht.ht_tags.empty()) {
|
|
auto related_help = get_related(ht);
|
|
auto related_refs = vector<string>();
|
|
|
|
for (auto related : related_help) {
|
|
string name = related->ht_name;
|
|
switch (related->ht_context) {
|
|
case help_context_t::HC_COMMAND:
|
|
name = ":" + name;
|
|
break;
|
|
case help_context_t::HC_SQL_FUNCTION:
|
|
case help_context_t::HC_SQL_TABLE_VALUED_FUNCTION:
|
|
name = name + "()";
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
related_refs.push_back(name);
|
|
}
|
|
stable_sort(related_refs.begin(), related_refs.end());
|
|
|
|
out.append("See Also", &view_curses::VC_STYLE, A_UNDERLINE)
|
|
.append("\n")
|
|
.append(body_indent, ' ');
|
|
|
|
bool first = true;
|
|
size_t line_start = out.length();
|
|
for (const auto &ref : related_refs) {
|
|
if (!first) {
|
|
out.append(", ");
|
|
}
|
|
if ((out.length() - line_start + ref.length()) > width) {
|
|
out.append("\n")
|
|
.append(body_indent, ' ');
|
|
line_start = out.length();
|
|
}
|
|
out.append(ref, &view_curses::VC_STYLE, A_BOLD);
|
|
first = false;
|
|
}
|
|
}
|
|
}
|
|
|
|
void format_example_text_for_term(const help_text &ht,
|
|
const help_example_to_attr_line_fun_t eval,
|
|
size_t width, attr_line_t &out)
|
|
{
|
|
text_wrap_settings tws;
|
|
|
|
tws.with_width(width);
|
|
|
|
if (!ht.ht_example.empty()) {
|
|
int count = 1;
|
|
|
|
out.append(ht.ht_example.size() == 1 ? "Example" : "Examples",
|
|
&view_curses::VC_STYLE,
|
|
A_UNDERLINE)
|
|
.append("\n");
|
|
for (auto &ex : ht.ht_example) {
|
|
attr_line_t ex_line(ex.he_cmd);
|
|
size_t keyword_offset = 0;
|
|
const char *space = strchr(ex.he_cmd, ' ');
|
|
const char *prompt = "";
|
|
|
|
if (space) {
|
|
keyword_offset = space - ex.he_cmd;
|
|
}
|
|
if (count > 1) {
|
|
out.append("\n");
|
|
}
|
|
switch (ht.ht_context) {
|
|
case help_context_t::HC_COMMAND:
|
|
ex_line.insert(0, 1, ' ');
|
|
ex_line.insert(0, 1, ':');
|
|
ex_line.insert(1, ht.ht_name);
|
|
readline_command_highlighter(ex_line, 0);
|
|
break;
|
|
case help_context_t::HC_SQL_INFIX:
|
|
case help_context_t::HC_SQL_KEYWORD:
|
|
case help_context_t::HC_SQL_FUNCTION:
|
|
case help_context_t::HC_SQL_TABLE_VALUED_FUNCTION:
|
|
readline_sqlite_highlighter(ex_line, 0);
|
|
prompt = ";";
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
|
|
out.append("#")
|
|
.append(to_string(count))
|
|
.append(" ")
|
|
.append(ex.he_description, &tws.with_indent(3))
|
|
.append(":\n ")
|
|
.append(prompt)
|
|
.append(ex_line, &tws.with_indent(3 + keyword_offset + 1))
|
|
.append("\n")
|
|
.append(3, ' ')
|
|
.append(eval(ht, ex), &tws.with_indent(3))
|
|
.append("\n");
|
|
|
|
count += 1;
|
|
}
|
|
}
|
|
}
|
|
|
|
static std::string link_name(const help_text &ht)
|
|
{
|
|
const static std::regex SCRUBBER("[^\\w_]");
|
|
|
|
bool is_sql_infix = ht.ht_context == help_context_t::HC_SQL_INFIX;
|
|
string scrubbed_name;
|
|
|
|
if (is_sql_infix) {
|
|
scrubbed_name = "infix";
|
|
} else {
|
|
scrubbed_name = ht.ht_name;
|
|
}
|
|
for (auto ¶m : ht.ht_parameters) {
|
|
if (!is_sql_infix && param.ht_name[0]) {
|
|
continue;
|
|
}
|
|
if (!param.ht_flag_name) {
|
|
continue;
|
|
}
|
|
|
|
scrubbed_name += "_";
|
|
scrubbed_name += param.ht_flag_name;
|
|
}
|
|
scrubbed_name = std::regex_replace(scrubbed_name, SCRUBBER, "_");
|
|
|
|
return tolower(scrubbed_name);
|
|
}
|
|
|
|
void format_help_text_for_rst(const help_text &ht,
|
|
const help_example_to_attr_line_fun_t eval,
|
|
FILE *rst_file)
|
|
{
|
|
const char *prefix;
|
|
int out_count = 0;
|
|
|
|
if (!ht.ht_name || !ht.ht_name[0]) {
|
|
return;
|
|
}
|
|
|
|
bool is_sql_func = false, is_sql = false;
|
|
switch (ht.ht_context) {
|
|
case help_context_t::HC_COMMAND:
|
|
prefix = ":";
|
|
break;
|
|
case help_context_t::HC_SQL_FUNCTION:
|
|
case help_context_t::HC_SQL_TABLE_VALUED_FUNCTION:
|
|
is_sql = is_sql_func = true;
|
|
prefix = "";
|
|
break;
|
|
case help_context_t::HC_SQL_INFIX:
|
|
case help_context_t::HC_SQL_KEYWORD:
|
|
is_sql = true;
|
|
prefix = "";
|
|
break;
|
|
default:
|
|
prefix = "";
|
|
break;
|
|
}
|
|
|
|
fprintf(rst_file, "\n.. _%s:\n\n", link_name(ht).c_str());
|
|
out_count += fprintf(rst_file, "%s%s", prefix, ht.ht_name);
|
|
if (is_sql_func) {
|
|
out_count += fprintf(rst_file, "(");
|
|
}
|
|
bool needs_comma = false;
|
|
for (auto ¶m: ht.ht_parameters) {
|
|
if (needs_comma) {
|
|
if (param.ht_flag_name) {
|
|
out_count += fprintf(rst_file, " ");
|
|
} else {
|
|
out_count += fprintf(rst_file, ", ");
|
|
}
|
|
}
|
|
if (!is_sql_func) {
|
|
out_count += fprintf(rst_file, " ");
|
|
}
|
|
|
|
if (param.ht_flag_name) {
|
|
out_count += fprintf(rst_file, "%s ", param.ht_flag_name);
|
|
}
|
|
if (param.ht_name[0]) {
|
|
out_count += fprintf(rst_file, "*");
|
|
if (param.ht_nargs == help_nargs_t::HN_OPTIONAL) {
|
|
out_count += fprintf(rst_file, "\\[");
|
|
}
|
|
out_count += fprintf(rst_file, "%s", param.ht_name);
|
|
if (param.ht_nargs == help_nargs_t::HN_OPTIONAL) {
|
|
out_count += fprintf(rst_file, "\\]");
|
|
}
|
|
out_count += fprintf(rst_file, "*");
|
|
}
|
|
if (is_sql_func) {
|
|
needs_comma = true;
|
|
}
|
|
}
|
|
if (is_sql_func) {
|
|
out_count += fprintf(rst_file, ")");
|
|
}
|
|
fprintf(rst_file, "\n");
|
|
fprintf(rst_file, "%s\n\n", string(out_count, '^').c_str());
|
|
|
|
fprintf(rst_file, " %s\n", ht.ht_summary);
|
|
fprintf(rst_file, "\n");
|
|
if (ht.ht_description) {
|
|
fprintf(rst_file, " %s\n", ht.ht_description);
|
|
}
|
|
|
|
int param_count = 0;
|
|
for (auto ¶m: ht.ht_parameters) {
|
|
if (param.ht_summary && param.ht_summary[0]) {
|
|
param_count += 1;
|
|
}
|
|
}
|
|
|
|
if (param_count > 0) {
|
|
fprintf(rst_file, " **Parameters**\n");
|
|
for (auto ¶m: ht.ht_parameters) {
|
|
if (param.ht_summary && param.ht_summary[0]) {
|
|
fprintf(rst_file, " * **%s%s** --- %s\n",
|
|
param.ht_name,
|
|
param.ht_nargs == help_nargs_t::HN_REQUIRED ? "\\*" : "",
|
|
param.ht_summary);
|
|
}
|
|
}
|
|
fprintf(rst_file, "\n");
|
|
}
|
|
if (is_sql) {
|
|
prefix = ";";
|
|
}
|
|
if (!ht.ht_example.empty()) {
|
|
fprintf(rst_file, " **Examples**\n");
|
|
for (auto &example: ht.ht_example) {
|
|
fprintf(rst_file, " %s:\n\n", example.he_description);
|
|
fprintf(rst_file, " .. code-block:: %s\n\n",
|
|
is_sql ? "custsqlite" : "lnav");
|
|
if (ht.ht_context == help_context_t::HC_COMMAND) {
|
|
fprintf(rst_file, " %s%s %s\n", prefix, ht.ht_name,
|
|
example.he_cmd);
|
|
} else {
|
|
fprintf(rst_file, " %s%s\n", prefix, example.he_cmd);
|
|
}
|
|
auto result = eval(ht, example);
|
|
if (!result.empty()) {
|
|
vector<attr_line_t> lines;
|
|
|
|
result.split_lines(lines);
|
|
for (auto &line : lines) {
|
|
fprintf(rst_file, " %s\n", line.get_string().c_str());
|
|
}
|
|
}
|
|
fprintf(rst_file, "\n");
|
|
}
|
|
}
|
|
|
|
if (!ht.ht_tags.empty()) {
|
|
auto related_refs = vector<string>();
|
|
|
|
for (auto related : get_related(ht)) {
|
|
related_refs.emplace_back(fmt::format(":ref:`{}`", link_name(*related)));
|
|
}
|
|
stable_sort(related_refs.begin(), related_refs.end());
|
|
|
|
fmt::print(rst_file, " **See Also**\n {}\n",
|
|
fmt::join(related_refs, ", "));
|
|
}
|
|
|
|
fprintf(rst_file, "\n----\n\n");
|
|
}
|